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.
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
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 knowledge base, and you can search it in natural language over the hosted MCP directory — no account required. To import, credential, and execute an operation, stand up your own Jentic One instance (see the Quickstart).
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
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
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:
- Discord: Post your OpenAPI spec link in
#api-requests. - GitHub: Open an issue at jentic/jentic-public-apis 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 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, 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
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 }}