Install Jentic One Beta

Connect the JigsawStack API to your agent

Jentic One is a self-hosted execution layer for AI agents. It lets your agent call the JigsawStack API, or any other public or private API you need. You set the rules, the agent never sees your credentials, and every call is logged.

Two steps, two machines. Install the instance in a safe environment, then register your agent from wherever it runs.

Step 1: Jentic One Host machine

# On the machine that will host your Jentic One instance:
curl -fsSL "https://jentic.com/install.sh?src=apis&api=%2Fapis%2Fjigsawstack.com%2Fjigsawstack" | sh

Step 2: Agent machine

# On the machine where your agent runs (keep this separate from the instance):
curl -fsSL "https://jentic.com/install.sh?src=apis&api=%2Fapis%2Fjigsawstack.com%2Fjigsawstack" | sh
jentic register       # connects your agent to your Jentic One instance

Jentic One is in public beta. The setup above keeps your agent separate from the instance, which is what you want before using real credentials: an agent running as the same OS user as Jentic One can read its stored keys directly. Just evaluating? A single local install is fine to start. See the secure deployment guide for the tiers.

Capabilities

What an agent can do with JigsawStack API.

Run a web search with an optional AI overview and scrape a page with prompts that name the elements you want extracted

Translate text between languages and translate the text inside an image to a target_language

Transcribe audio from a URL or stored file, with speaker separation and a webhook_url for long jobs

Generate speech from text and clone, list, or delete custom voices by voice_id

GET STARTED

Start building with JigsawStack API

Explore with Jentic One

View OpenAPI Document

Use Cases

Patterns agents use JigsawStack API for, with concrete tasks.

★ Agent Research and Extraction via Jentic

An AI agent that needs live web facts can call the JigsawStack web search operation for a query, then pass the most relevant URL to the AI scraper with element prompts describing the data it wants, such as prices or headlines. Through Jentic the agent discovers both operations by intent and calls them with your stored key, so a research task becomes two structured calls instead of hand-written scraping code.

Search the web for 'best open source vector databases 2026', then scrape the top result URL with element prompts for each database name and its license, and return a table

Multilingual Content Translation

Teams localising user-generated content send text to the JigsawStack translate operation with a target_language and get back the translated text, with current_language optional when the source is unknown. Screenshots and product images go to the image translation operation, which translates the text inside the image, so one integration covers both written and visual content.

Translate a product description into French and German, then translate the text in the product's packaging image at a given URL into French

Speech Transcription and Voice Output

Podcast and meeting tools send audio by URL or file_store_key to the transcribe operation, set by_speaker to separate speakers, and pass a webhook_url so long recordings report back when done. The same API turns text back into audio with text-to-speech and can clone a custom voice that is later listed or removed by voice_id.

Transcribe the meeting recording at a given URL with by_speaker enabled and a webhook_url for completion, then summarise what each speaker said

Text-to-SQL for Internal Data Questions

An analyst assistant sends a plain-English question as the prompt along with a sql_schema describing the tables, and the JigsawStack SQL operation returns a query for a chosen database dialect. The assistant runs the query against its own database, so the model never needs direct database credentials.

Given a schema with orders and customers tables, generate a PostgreSQL query that returns the ten customers with the highest total order value last quarter

Content Moderation Checks

Community platforms screen posts before publishing by calling the JigsawStack spam check, profanity, and sentiment operations on the text, with censor_replacement available to mask profane words, and the NSFW validation operation on attached images. Each check is a single call, so a moderation step can run on every submission.

Check a new forum post for spam and profanity, mask any profane words with '*', score its sentiment, and screen its attached image for NSFW content before approving it

Key Endpoints

37 endpoints — the jigsawstack api runs a set of small task-specific ai models behind one key: web search and scraping, text and image translation, speech transcription, text-to-speech, vision ocr, object detection, embeddings, and classification.

METHOD

PATH

DESCRIPTION

POST

/web/search

Search the web with an optional AI overview

POST

/ai/scrape

Scrape a page using element prompts

POST

/ai/translate

Translate text

POST

/ai/transcribe

Transcribe audio

POST

/vocr

Extract text with vision OCR

POST

/ai/sql

Generate SQL from a prompt

POST

/embedding

Generate embeddings

POST

/web/search

Search the web with an optional AI overview

POST

/ai/scrape

Scrape a page using element prompts

POST

/ai/translate

Translate text

POST

/ai/transcribe

Transcribe audio

POST

/vocr

Extract text with vision OCR

POST

/ai/sql

Generate SQL from a prompt

POST

/embedding

Generate embeddings

Why Jentic?

What agents get from Jentic-routed access to this vendor.

Setup

Wiring JigsawStack by hand means sending its `x-api-key` header on every call and learning a different request body for each of its search, scrape, speech, vision, and SQL operations. Through Jentic you install once, import JigsawStack from the API Directory, store the key once, and your agent calls it.

Permission scoping

Most JigsawStack operations carry their target in the request body, so rules bound which operations your agent may call, such as web search and translation. A few resources sit in the URL path, like saved prompts at /prompt_engine/{id} and stored files at /store/file/read/{key}, so those can be narrowed to one prompt or file. You choose the operations it may call, so destructive ones like deleting a stored file or a cloned voice are not included unless you add them.

Credential isolation

Your JigsawStack API key is stored once, encrypted, by your own Jentic One instance and injected at execution time. It never enters the agent's prompt, logs, or context.

Intent-based discovery

Agents search Jentic by intent such as 'scrape a web page' or 'translate text', and Jentic returns the matching JigsawStack operation with its input schema so the agent calls the right endpoint without browsing the reference docs.

FAQs

Specific to using JigsawStack API through Jentic.

What authentication does the JigsawStack API use?

The JigsawStack API authenticates with an API key sent in the `x-api-key` header, per its OpenAPI spec, which applies the key across its operations. Through Jentic the key is stored encrypted by your own Jentic One instance and injected at call time, so it never appears in your agent's prompt or logs.

Is there a JigsawStack MCP server?

You don't need an MCP server to give your agent JigsawStack. Jentic connects it directly from the API Directory: import it, store your key once, and your agent calls search, scrape, translate, and the other operations as it needs them. Operations are discovered on demand, so no extra server's tool definitions sit in your agent's context.

Can I limit what my agent is allowed to do with the JigsawStack API?

Yes. For example, write a rule that allows only the web search, AI scrape, and translate operations, so a research agent can look things up, extract page content, and translate it but cannot delete stored files or cloned voices. Where an id is in the path, such as /prompt_engine/{id}, you can narrow a rule to a single saved prompt, and every call the agent makes is logged.

Can I scrape a website with a prompt instead of CSS selectors using the JigsawStack API?

Yes. The AI scrape operation accepts a url and element_prompts describing what to extract, and also accepts selectors, cookies, http_headers, and wait_for options when a page needs them. You can pass raw html instead of a URL when you already have the page content.

What are the rate limits for the JigsawStack API?

The JigsawStack OpenAPI spec does not specify rate limits. Check the JigsawStack documentation at https://jigsawstack.com for the current limits on your plan.

How do I transcribe audio with the JigsawStack API through Jentic?

Search Jentic for an intent like 'transcribe an audio file', import JigsawStack from the API Directory, and store your API key once. Your agent then calls the transcribe operation (POST /ai/transcribe) with a url or file_store_key, optionally setting by_speaker and a webhook_url for long recordings. To run it on your own infrastructure, install Jentic One from its GitHub repo.

JigsawStack API

AI ReadinessNon-Ready (F)0/100

See full scorecard

Official vendor OpenAPI document · agent-readyAI/MLMl InferenceapiKey37 EndpointsREST

For Agents

Search and scrape the web, translate text and images, transcribe audio, generate speech, run OCR and object detection, and produce embeddings through one JigsawStack key. Includes text-to-SQL, sentiment, spam, and profanity checks plus a file store and saved prompts.

Use for: I need to search the web and get an AI overview of the results, Scrape the product prices from this page using a plain-English prompt, Translate this paragraph into Spanish, Transcribe this podcast episode and split it by speaker

Not supported: Does not handle general chat completion, model fine-tuning, or database hosting. Use for task-specific AI operations such as search, scraping, translation, speech, and vision only.

The JigsawStack API runs a set of small task-specific AI models behind one key: web search and scraping, text and image translation, speech transcription, text-to-speech, vision OCR, object detection, embeddings, and classification. It also turns a plain-English prompt into SQL against a schema you supply, scores text for sentiment, spam, and profanity, and screens images for NSFW content. A file store lets you upload a file once and reference it by its file_store_key in later calls, and the prompt engine saves reusable prompts you can run by id.

Jentic One on Github View OpenAPI Document

Show dimension breakdown

Foundational Compliance

Base layer of spec validity and structural soundness.

Grade: A-Signals: 4

96%

Lint Results

Aggregated quality score from linter diagnostics, weighted by severity.

100%

Resolution Completeness

Percentage of `$ref` references that resolve successfully.

100%

Specification Validity

Checks whether the API description parses successfully and conforms to its declared specification (e.g., OpenAPI).

Structural Integrity

Structural correctness score based on schema issues using logarithmic dampening.

Developer Experience & Jentic Compatibility

Clarity, completeness, and ingestion readiness for developers and tooling.

Grade: B+Signals: 4

Example Density

How richly the API is illustrated with examples.

100%

Example Validity

Percentage of examples that conform to their schemas.

75%

Response Coverage

Percentage of operations with complete response definitions (success, client error, server error).

100%

Tooling Readiness

Health of API ingestion, bundling, and resolution within Jentic pipelines.

AI-Readiness & Agent Experience

Semantic breadth, depth, and agent comprehension for AI systems.

Grade: D+Signals: 4

42%

Description Coverage

Coverage of descriptions across API elements.

Error Standardization

Coverage of RFC 9457 Problem Details for error responses.

100%

OperationId Quality

Coverage, uniqueness, and casing consistency of operationIds for AI inference.

53%

Summary Coverage

Coverage of summaries across operations/tags/info.

Agent Usability

Functional utility, complexity comfort, and AI orchestration readiness.

Grade: A+Signals: 1

94%

Complexity Comfort

Agent comfort level based on API operational and structural complexity.

Security

Trust, risk posture, and security compliance.

Grade: C-Signals: 1

50%

Authentication Strength

Average quality of security schemes based on authentication method strength (weakest link for OAuth2).

AI Discoverability

Findability, semantic richness, and reasoning readiness.

Grade: FSignals: 1

Descriptive Richness

Clarity and depth of descriptions across API elements.

Connect the JigsawStack API to your agent

Capabilities

Start building with JigsawStack API

Use Cases

Key Endpoints

Why Jentic?

Related APIs

FAQs

JigsawStack API

Jentic AI Readiness Score

JigsawStack API

Foundational Compliance

Lint Results

Resolution Completeness

Specification Validity

Structural Integrity

Developer Experience & Jentic Compatibility

Example Density

Example Validity

Response Coverage

Tooling Readiness

AI-Readiness & Agent Experience

Description Coverage

Error Standardization

OperationId Quality

Summary Coverage

Agent Usability

Complexity Comfort

Security

Authentication Strength

AI Discoverability

Descriptive Richness