--- canonical: https://docs.jentic.com/community/faq/ representation: markdown-alternate # Canonical page: https://docs.jentic.com/community/faq/ # This is the Markdown alternate of the page above. title: "Jentic Agent & API FAQ — MCP, SDK, Credentials" description: >- Answers to the most common Jentic questions on business agents, API search, credentials, MCP, and open standards, grouped by topic so you find them fast. --- # FAQ – Jentic This FAQ collects the most common questions from the community, Discord, and our docs — grouped by topic so you can find answers quickly. If you’re new to Jentic, start with the [Quickstart](../getting-started/quickstart.md). --- ## 1. Business Agents **What is a Business Agent?** A Business Agent is an AI system that **plans and executes real-world tasks** by calling external APIs and workflows — securely, observably, and under your organization’s controls. → Learn more: [Business Agents concept](../concepts/business-agents.md) **Do I need Jentic to build one?** No. You can build agents without Jentic, but we handle the **undifferentiated heavy lifting** (auth, cataloging, workflows, observability) and align everything to **open standards**. **Can I bring my own private APIs?** Yes. You can import private APIs and workflows, then control access at the agent level. (Self-hosted deployment support is on the roadmap.) **Does Jentic lock me in?** No. Jentic is **open-standards-first** (OpenAPI, Arazzo, MCP). Your API definitions, workflows, and integrations remain portable. --- ## 2. API Search **What is API Search?** API Search is the **in-app catalog** of real-world capabilities from **thousands of APIs**, **tens of thousands of operations**, and **multi-step workflows** — all ready to be used by your agents. **Can I browse APIs without an account?** Yes. The full catalog is the open-source [Jentic Public APIs](../reference/public-apis/overview.md) knowledge base, and you can search it in natural language over the [hosted MCP directory](../guides/mcp/remote-mcp.md) — no account required. To *import, credential, and execute* an operation, stand up your own [Jentic One](../reference/jentic-one/index.md) instance (see the [Quickstart](../getting-started/quickstart.md)). **Are the counts exact?** No — the catalog updates continuously. Expect the numbers to grow over time. **Do I paste raw API secrets into prompts?** Never. Credentials are stored encrypted in your Jentic One Broker and injected at execution time — they never reach the agent, its prompts, or the response. → See: [API Search – Getting Started](../getting-started/api-search.md) --- ## 3. Jentic Public APIs **What is the Jentic Public APIs repository?** It’s an open-source, AI-optimized catalog of public APIs and workflows, designed to make APIs **machine-readable and agent-ready**. → Read the [Jentic Manifesto](https://github.com/jentic/jentic-public-apis/blob/main/OAK.md) **What’s inside?** * 📄 **OpenAPI Descriptions** – Formal API descriptions or documents * 🔁 **Arazzo workflows** – Declarative, composable, multi-call workflows * 🧪 **Evaluations** – Scorecards for API quality & AI-readiness * 📂 **Organized structure** – By vendor, version, and use-case * 📃 **RFCs** – Proposals for improving API standards for agentic use **Why is it different?** * 📚 **Comprehensive** — APIs and multi-step workflows in one place * 🧠 **AI-first** — Structured for LLM consumption * 🔓 **Open** — Built on OpenAPI, Arazzo, MCP * 🤝 **Community-driven** — Anyone can contribute * 🛠️ **Tool-ready** — Integrates with the Arazzo Engine for execution --- ## 4. Contributing APIs & Workflows **How can I contribute an API or workflow?** Two options: 1. **Discord:** Post your OpenAPI spec link in [`#api-requests`](https://discord.gg/TdbWXZsUSm). 2. **GitHub:** Open an issue at [jentic/jentic-public-apis](https://github.com/jentic/jentic-public-apis/issues) using the **“Import OpenAPI to Jentic Public APIs”** template. **What do I need to provide?** * URL to the OpenAPI spec * Unique name for the directory in the repo Moderators or staff will review and process your contribution. --- ## 5. CLI & Tools **How do agents call Jentic?** Through your self-hosted [Jentic One](../reference/jentic-one/index.md) instance — via the `jentic` CLI (`search` → `inspect` → `execute`) or over MCP. The retired `jentic-sdks` Python/TypeScript libraries and the hosted `app.jentic.com` platform are no longer used. **Do you support MCP?** Yes. Search the public API directory in natural language over the [hosted MCP server](../guides/mcp/remote-mcp.md), and connect your own Jentic One instance as a custom connector for the full search → inspect → execute loop in tools like Claude, Windsurf, Cursor, and ChatGPT. → See: [MCP overview](../guides/mcp/remote-mcp.md) --- ## 6. Accounts & Security **Is my data secure?** Yes. API credentials are stored encrypted in your Jentic One Broker and injected at execution time — they are never sent to the LLM or returned to a caller. Access is default-deny: each agent is granted only the operations an operator explicitly approves. **Can I rotate credentials?** Yes — credentials and agent tokens can be revoked and regenerated at any time from your Jentic One dashboard. **Does Jentic store execution logs?** Yes, for observability. Every brokered call writes an execution record, visible under **Monitor → Executions** in your instance. --- ## 7. Troubleshooting **401 Unauthorized** – Check that: * The agent has been approved on your instance (`jentic register`, then approve at `/app`) * The operator has granted the agent access to the operation you’re calling **Missing credentials** – Add them under **Credentials** in your Jentic One dashboard. **MCP client can’t connect** – Restart the client after updating its config. --- *Last updated: {{ git\_revision\_date\_localized }}*