Locus Pro: pay-per-use APIs billed to one credit balance.
For repeatable Workflows, load the registered locus-workflows-stage skill when available; otherwise call get_locus_guide. Call web_research for grounded answers, web_extract for exact URLs, router_web_search for sources, or commerce_search for products. Otherwise use search_apis(query), then execute(slug, args) with its returned schema. For enabled:false, call request_tool_access and send its approval_url to the human. describe_api(slug) refreshes contracts. Pass max_credits to cap a charge. Read balances with get_balance().
Calls are live and billed; charges appear in structuredContent and _meta. RETRIES: pass "idempotency_key" to execute (or _meta "locus/idempotencyKey" on any burn tool) — the same key never double-charges. Without one, retries deduplicate best-effort; intentional repeats need a fresh key. Replays carry idempotent_replay:true and no new charge. When an error returns approval_token and idempotency_key, call execute again with both unchanged. Use ?compact=1 for compact text.
AUTH: interactive clients use discovered OAuth and consent. Service credentials include tenant keys and scoped agent credentials; end-user credentials remain user-bound. Failures return isError:true with an actionable hint.
Protocol
Pass100/10020 / 20 pts
Connection, authentication, and protocol compatibility.
The title clearly communicates the tool’s action and subject. Keep it concise.
Description96/100
Search the catalog by keyword for endpoints to call; returns slug, price, and enabled state, enabled first. Start here; use describe_api for one endpoint's full schema. Free.
The description explains the capability, when to use it, and what to expect.
Inputs86/100
Clarify units, where to obtain this value, or conventions not already expressed in the schema.
query
Outcome or provider search phrase. Optional when category or pack is supplied.
Clear enough to supply this argument.
category
Canonical category ID or an unambiguous live category alias.
Clarify units, where to obtain this value, or conventions not already expressed in the schema.
pack
Canonical curated-pack ID or an unambiguous live pack alias.
Remove validation rules already expressed in this field’s schema; describe its meaning and usage instead.
enabled
Filter to enabled or disabled endpoints. Defaults to true; pass "all" to include both, ranked enabled-first.
Clear enough to supply this argument.
limit
Results: default 5, max 50.
Remove validation rules already expressed in this field’s schema; describe its meaning and usage instead.
cursor
Opaque next_cursor from a prior search with the same filters.
Clear enough to supply this argument.
include_facets
Include bounded principal-scoped category and pack counts.
The title clearly communicates the tool’s action and subject. Keep it concise.
Description86/100
Create a short-lived approval link for one disabled (enabled:false) endpoint; send its URL to a human, who enables it. Enables and calls nothing itself; free.
Describe the returned information so the agent knows whether it will answer the request.
Inputs91/100
Input documentation gives an agent enough context to populate the arguments.
The title clearly communicates the tool’s action and subject. Keep it concise.
Description91/100
Browse catalog categories and packs (curated endpoint bundles) to orient before search_apis. Lists only: it enables nothing (use request_tool_access) and calls nothing (use execute). Free.
The description explains the capability, when to use it, and what to expect.
Inputs63/100
Remove validation rules already expressed in this field’s schema; describe its meaning and usage instead.
group_type
Group type.
Remove validation rules already expressed in this field’s schema; describe its meaning and usage instead.
query
Name filter.
Explain the meaning of this value, not just its name.
limit
Page size.
Remove validation rules already expressed in this field’s schema; describe its meaning and usage instead.
cursor
Prior next_cursor.
Explain the meaning of this value, not just its name.
The title clearly communicates the tool’s action and subject. Keep it concise.
Description81/100
Fetch a Locus how-to guide as text when no Locus skill files are installed; otherwise prefer the skill. Omit id to list guides, or pass task to get the one for your goal. Free.
The description explains the capability, when to use it, and what to expect.
Inputs75/100
Remove validation rules already expressed in this field’s schema; describe its meaning and usage instead.
id
Omit to list or pick by task.
Remove validation rules already expressed in this field’s schema; describe its meaning and usage instead.
task
Your goal, to pick a guide.
Remove validation rules already expressed in this field’s schema; describe its meaning and usage instead.
version
Omit for latest.
Remove validation rules already expressed in this field’s schema; describe its meaning and usage instead.
section
Section ID; omit for all.
Remove validation rules already expressed in this field’s schema; describe its meaning and usage instead.
cursor
Prior next_cursor.
Remove validation rules already expressed in this field’s schema; describe its meaning and usage instead.
max_characters
Chunk size.
Remove validation rules already expressed in this field’s schema; describe its meaning and usage instead.
The title clearly communicates the tool’s action and subject. Keep it concise.
Description97/100
Get one endpoint's full contract by slug: input schema, example, output shape, price. Use before the first execute or after an args rejection; get the slug from search_apis. Free.
The description explains the capability, when to use it, and what to expect.
Inputs55/100
Remove validation rules already expressed in this field’s schema; describe its meaning and usage instead.
slug
provider/endpoint slug.
Remove validation rules already expressed in this field’s schema; describe its meaning and usage instead.
operation_offset
MPP operation index or continuation offset.
Explain the meaning of this value, not just its name.
operation_query
Search operations or fal/generate models.
Explain the meaning of this value, not just its name.
model
Exact fal model ID.
Clarify units, where to obtain this value, or conventions not already expressed in the schema.
model_cursor
Fal page cursor.
Explain the meaning of this value, not just its name.
The title clearly communicates the tool’s action and subject. Keep it concise.
Description95/100
Pin (pinned:true, the default) or unpin one enabled endpoint so it appears as its own typed tool on every MCP connection of this workspace instead of going through execute. Use for endpoints you call repeatedly. Each pin adds its schema to every session's context, so the first pin requires acknowledge_context_cost:true. Persistent and workspace-wide; does not enable or call the endpoint.
The description explains the capability, when to use it, and what to expect.
Inputs50/100
Clarify units, where to obtain this value, or conventions not already expressed in the schema.
slug
Exact provider/endpoint slug.
Clarify units, where to obtain this value, or conventions not already expressed in the schema.
pinned
True to pin (default), false to unpin.
Clear enough to supply this argument.
acknowledge_context_cost
Required once: pinned schemas use model context on every connection.
Resolve the mismatch between this description and its schema constraints.
{
"name": "pin_endpoint",
"title": "Pin endpoint",
"description": "Pin (pinned:true, the default) or unpin one enabled endpoint so it appears as its own typed tool on every MCP connection of this workspace instead of going through execute. Use for endpoints you call repeatedly. Each pin adds its schema to every session's context, so the first pin requires acknowledge_context_cost:true. Persistent and workspace-wide; does not enable or call the endpoint.",
"inputSchema": {
"type": "object",
"required": [
"slug"
],
"properties": {
"slug": {
"type": "string",
"pattern": "^[a-z0-9][a-z0-9._-]*/[a-z0-9][a-z0-9._-]*$",
"maxLength": 256,
"description": "Exact provider/endpoint slug."
},
"pinned": {
"type": "boolean",
"description": "True to pin (default), false to unpin."
},
"acknowledge_context_cost": {
"type": "boolean",
"description": "Required once: pinned schemas use model context on every connection."
}
},
"additionalProperties": false
},
"outputSchema": {
"type": "object",
"properties": {
"slug": {
"type": "string"
},
"pinned": {
"type": "boolean"
},
"pinned_count": {
"type": "integer"
}
}
},
"annotations": {
"readOnlyHint": false,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}
The title clearly communicates the tool’s action and subject. Keep it concise.
Description80/100
Read the remaining credit balance: the pooled account, or one end user via external_user_id with a secret key. Use before a large spend or after an insufficient-credits error. Free.
Describe the returned information so the agent knows whether it will answer the request.
Inputs75/100
Remove validation rules already expressed in this field’s schema; describe its meaning and usage instead.
external_user_id
End-user id; secret-key auth only.
Remove validation rules already expressed in this field’s schema; describe its meaning and usage instead.
The title clearly communicates the tool’s action and subject. Keep it concise.
Description81/100
Read an earlier call's stored result by receipt ID in chunks (offset or page, max_characters); wait_seconds waits for a still-running call. Use when execute truncated the result. Free.
The description explains the capability, when to use it, and what to expect.
Inputs60/100
Explain the meaning of this value, not just its name.
api_call_id
Receipt ID.
Explain the meaning of this value, not just its name.
offset
Character offset; default 0.
Remove validation rules already expressed in this field’s schema; describe its meaning and usage instead.
max_characters
Default 8000.
Remove validation rules already expressed in this field’s schema; describe its meaning and usage instead.
wait_seconds
Async wait.
Explain the meaning of this value, not just its name.
page
Prior next_page.
Explain the meaning of this value, not just its name.
The title clearly communicates the tool’s action and subject. Keep it concise.
Description96/100
List recent billed calls, newest first, with call ID, endpoint, status, credits, and error summary. Use to audit spend or find an ID for get_call_result or report_bug; filter by status or provider. Free, paged.
The description explains the capability, when to use it, and what to expect.
Inputs69/100
Remove validation rules already expressed in this field’s schema; describe its meaning and usage instead.
limit
Default 10.
Remove validation rules already expressed in this field’s schema; describe its meaning and usage instead.
cursor
Prior next_cursor.
Remove validation rules already expressed in this field’s schema; describe its meaning and usage instead.
status
Default all.
Remove validation rules already expressed in this field’s schema; describe its meaning and usage instead.
provider
Provider ID.
Explain the meaning of this value, not just its name.
The title clearly communicates the tool’s action and subject. Keep it concise.
Description95/100
List durable resources your calls created that persist, expire, or keep costing, such as AgentMail inboxes, phone numbers, and E2B sandboxes, with service, status, and expiry. Use to find what to release or renew (POST /credits/resources/{id}/release or /renew); listing changes nothing. Free, paged.
The description explains the capability, when to use it, and what to expect.
Inputs75/100
Remove validation rules already expressed in this field’s schema; describe its meaning and usage instead.
status
Defaults to all.
Remove validation rules already expressed in this field’s schema; describe its meaning and usage instead.
service
Service name or provider slug.
Remove validation rules already expressed in this field’s schema; describe its meaning and usage instead.
end_user
Only rows for this end user.
Clarify units, where to obtain this value, or conventions not already expressed in the schema.
The title clearly communicates the tool’s action and subject. Keep it concise.
Description88/100
File a bug report with the Locus team after a wrong result or error; include call_id and tool so it can be traced. Charges nothing, does not retry or refund, and gets no in-session reply.
The description explains the capability, when to use it, and what to expect.
Inputs56/100
Remove validation rules already expressed in this field’s schema; describe its meaning and usage instead.
message
What went wrong.
Remove validation rules already expressed in this field’s schema; describe its meaning and usage instead.
call_id
Call ID.
Explain the meaning of this value, not just its name.
tool
Tool name.
Explain the meaning of this value, not just its name.
context
JSON, max 8 KB.
Explain the meaning of this value, not just its name.
The title clearly communicates the tool’s action and subject. Keep it concise.
Description88/100
Call one enabled endpoint by slug with args from its schema; charges credits. Get the slug from search_apis. max_credits caps the charge. A stable idempotency_key makes retries exactly-once (idempotent_replay:true). Long results continue via get_call_result.
Explain mutations, irreversible effects, or prerequisites that matter before calling this tool.
Inputs54/100
Remove validation rules already expressed in this field’s schema; describe its meaning and usage instead.
slug
provider/endpoint slug.
Remove validation rules already expressed in this field’s schema; describe its meaning and usage instead.
args
Endpoint args; call describe_api for schema.
Explain the meaning of this value, not just its name.
idempotency_key
Reuse on retry; charges once.
Remove validation rules already expressed in this field’s schema; describe its meaning and usage instead.
loop_id
Agent loop ID when policy requires one.
Remove validation rules already expressed in this field’s schema; describe its meaning and usage instead.
max_credits
Most credits this call may charge.
Clarify units, where to obtain this value, or conventions not already expressed in the schema.
approval_token
From an approval error; send its idempotency_key.
Resolve the mismatch between this description and its schema constraints.
The title clearly communicates the tool’s action and subject. Keep it concise.
Description94/100
Manage customer-owned Workflow code: list, create, update, get, clone, archive, or save. Use for authoring and versioning only; use workflow_validate to check code and workflow_run to execute it. save publishes one exact draft revision and requires that revision to have passed workflow_validate. None of these actions runs code or charges credits.
The description explains the capability, when to use it, and what to expect.
Inputs79/100
Remove validation rules already expressed in this field’s schema; describe its meaning and usage instead.
action
Lifecycle action. Its required fields are described below.
Remove validation rules already expressed in this field’s schema; describe its meaning and usage instead.
workflow_id
Required for get, update, clone, archive, and save.
Remove validation rules already expressed in this field’s schema; describe its meaning and usage instead.
revision
Exact current draft revision for update, archive, or save.
Remove validation rules already expressed in this field’s schema; describe its meaning and usage instead.
source
Complete inline files or a tenant-owned artifact for create/update; mutually exclusive with source_patch. Prefer the artifact returned by a successful inline check.
Clear enough to supply this argument.
source_patch › base_source_digest
Optional current draft digest for an additional stale-source guard.
Remove validation rules already expressed in this field’s schema; describe its meaning and usage instead.
source_patch › files › items › path
Draft-relative file path.
Remove validation rules already expressed in this field’s schema; describe its meaning and usage instead.
source_patch › files › items › content
Full file content; null deletes the file.
Remove validation rules already expressed in this field’s schema; describe its meaning and usage instead.
source_patch › edits › items › path
Draft-relative file path.
Remove validation rules already expressed in this field’s schema; describe its meaning and usage instead.
source_patch › edits › items › old_string
Exact text to replace; must occur exactly once unless replace_all.
Remove validation rules already expressed in this field’s schema; describe its meaning and usage instead.
source_patch › edits › items › new_string
Replacement text.
Remove validation rules already expressed in this field’s schema; describe its meaning and usage instead.
source_patch › edits › items › replace_all
Replace every occurrence instead of requiring exactly one.
Remove validation rules already expressed in this field’s schema; describe its meaning and usage instead.
validated_source_digest
For create: digest from a successful inline check. Matching source is rechecked and recorded as revision 1 evidence.
Remove validation rules already expressed in this field’s schema; describe its meaning and usage instead.
expected_revision
Compatibility alias for revision on update, archive, or save; prefer revision.
Clear enough to supply this argument.
idempotency_key
Stable key for create, clone, or update retries. It is stored only as a one-way hash.
Clear enough to supply this argument.
name
Optional new Workflow name for clone.
Remove validation rules already expressed in this field’s schema; describe its meaning and usage instead.
query
Optional case-insensitive name filter for list.
Remove validation rules already expressed in this field’s schema; describe its meaning and usage instead.
status
Definition status filter for list; defaults to active.
Remove validation rules already expressed in this field’s schema; describe its meaning and usage instead.
view
Response detail for get; defaults to summary. Full includes bounded source, versions, and validations.
Remove validation rules already expressed in this field’s schema; describe its meaning and usage instead.
limit
Page size for list: max 100.
Remove validation rules already expressed in this field’s schema; describe its meaning and usage instead.
cursor
Opaque next_cursor returned by a prior list with the same filters.
Remove validation rules already expressed in this field’s schema; describe its meaning and usage instead.
The title clearly communicates the tool’s action and subject. Keep it concise.
Description84/100
Check Workflow code without a production run. mode check validates inline source (before it is persisted) or one exact draft revision; mode fixtures runs that revision against isolated, no-network fixtures. Use before workflow_definition save, which requires a passing check, and before workflow_run. Makes no provider calls, so nothing is charged.
The description explains the capability, when to use it, and what to expect.
Inputs80/100
Remove validation rules already expressed in this field’s schema; describe its meaning and usage instead.
workflow_id
Required with revision for persisted draft checks and fixtures; omit only for an inline source check.
Remove validation rules already expressed in this field’s schema; describe its meaning and usage instead.
revision
Required with workflow_id for persisted draft checks and fixtures; exact current draft revision to validate.
Remove validation rules already expressed in this field’s schema; describe its meaning and usage instead.
source
Inline files or tenant-owned artifact for a pre-persistence check; mutually exclusive with workflow_id and revision. A successful inline check returns source_artifact_id.
Clear enough to supply this argument.
mode
check accepts either inline source or workflow_id plus revision. fixtures always requires workflow_id plus revision.
Remove validation rules already expressed in this field’s schema; describe its meaning and usage instead.
fixture_set
Optional named fixture export; valid only with persisted draft identity.
Remove validation rules already expressed in this field’s schema; describe its meaning and usage instead.
Describe the returned fields so an agent can interpret the result.
View output schema
{
"type": "object",
"properties": {
"validation": {
"type": "object",
"description": "Check or fixture outcome. A successful inline check includes source_artifact_id for exact reuse during definition creation."
}
},
"additionalProperties": true
}
Original tool metadata
{
"name": "workflow_validate",
"title": "Validate Workflow",
"description": "Check Workflow code without a production run. mode check validates inline source (before it is persisted) or one exact draft revision; mode fixtures runs that revision against isolated, no-network fixtures. Use before workflow_definition save, which requires a passing check, and before workflow_run. Makes no provider calls, so nothing is charged.",
"inputSchema": {
"type": "object",
"required": [
"mode"
],
"properties": {
"mode": {
"enum": [
"check",
"fixtures"
],
"type": "string",
"description": "check accepts either inline source or workflow_id plus revision. fixtures always requires workflow_id plus revision."
},
"source": {
"type": "object",
"description": "Inline files or tenant-owned artifact for a pre-persistence check; mutually exclusive with workflow_id and revision. A successful inline check returns source_artifact_id.",
"additionalProperties": true
},
"revision": {
"type": "integer",
"minimum": 1,
"description": "Required with workflow_id for persisted draft checks and fixtures; exact current draft revision to validate."
},
"fixture_set": {
"type": "string",
"maxLength": 120,
"description": "Optional named fixture export; valid only with persisted draft identity."
},
"workflow_id": {
"type": "string",
"maxLength": 80,
"description": "Required with revision for persisted draft checks and fixtures; omit only for an inline source check."
}
},
"description": "Pass either source, or workflow_id plus revision. The server enforces exclusivity for schema-simplifying hosts.",
"additionalProperties": false
},
"outputSchema": {
"type": "object",
"properties": {
"validation": {
"type": "object",
"description": "Check or fixture outcome. A successful inline check includes source_artifact_id for exact reuse during definition creation."
}
},
"additionalProperties": true
},
"annotations": {
"readOnlyHint": false,
"openWorldHint": false,
"idempotentHint": false,
"destructiveHint": false
}
}
The title clearly communicates the tool’s action and subject. Keep it concise.
Description95/100
Queue a run of one exact saved Workflow version. mode pilot is an isolated trial; mode run is production. max_charge_credits is a hard ceiling for the whole run. idempotency_key is required: resubmitting with the same key replays the existing run (replay:true) instead of starting another. Returns the run summary and poll_after_ms; follow progress, results, cancel, or resume with workflow_runs.
Explain mutations, irreversible effects, or prerequisites that matter before calling this tool.
Inputs72/100
Remove validation rules already expressed in this field’s schema; describe its meaning and usage instead.
action
Optional symmetry alias. Omit it or pass submit.
Remove validation rules already expressed in this field’s schema; describe its meaning and usage instead.
workflow_id
Workflow ID that owns the saved version.
Clear enough to supply this argument.
version
Exact immutable saved version; latest is not accepted.
Clear enough to supply this argument.
input
Inline Workflow input; mutually exclusive with input_artifact_id.
Explain the meaning of this value, not just its name.
input_artifact_id
Tenant-owned artifact holding the Workflow input.
Clarify units, where to obtain this value, or conventions not already expressed in the schema.
mode
pilot for an isolated trial run, run for production.
Clear enough to supply this argument.
max_charge_credits
Positive decimal hard cap for the complete run.
Clarify units, where to obtain this value, or conventions not already expressed in the schema.
max_rows
Maximum result rows: max 10000.
Remove validation rules already expressed in this field’s schema; describe its meaning and usage instead.
idempotency_key
Stable exactly-once retry key for submit.
Clarify units, where to obtain this value, or conventions not already expressed in the schema.
The title clearly communicates the tool’s action and subject. Keep it concise.
Description89/100
Inspect and control runs started by workflow_run: list runs, get one run's bounded status, page a stored provider-call response (call) or artifact without a new charge, cancel pending dispatch, or resume an eligible paused run with current authorization. Use for everything after a run is queued; use workflow_run to start one.
The description explains the capability, when to use it, and what to expect.
Inputs75/100
Remove validation rules already expressed in this field’s schema; describe its meaning and usage instead.
action
list, get, call, artifact, cancel, or resume.
Remove validation rules already expressed in this field’s schema; describe its meaning and usage instead.
run_id
Run ID; required for get, call, artifact, cancel, and resume.
Remove validation rules already expressed in this field’s schema; describe its meaning and usage instead.
call_id
Required for call; use an ID returned by get.
Remove validation rules already expressed in this field’s schema; describe its meaning and usage instead.
artifact_id
Artifact ID; required for artifact.
Remove validation rules already expressed in this field’s schema; describe its meaning and usage instead.
cursor
Opaque next_cursor from a prior list with the same filters.
Remove validation rules already expressed in this field’s schema; describe its meaning and usage instead.
max_characters
Characters: min 1024, max 20000.
Remove validation rules already expressed in this field’s schema; describe its meaning and usage instead.
limit
Page size for list: max 100.
Remove validation rules already expressed in this field’s schema; describe its meaning and usage instead.
The title clearly communicates the tool’s action and subject. Keep it concise.
Description88/100
Accept an email, LinkedIn URL, provider-qualified person ID, name plus company, or company identifier. Start with the benchmarked broadest provider, pass newly found identifiers down the waterfall, verify discovered emails and phones before accepting them, stop when requested fields are complete, and return field provenance plus verification evidence. Charged in credits per call. The result reports credits charged.
Describe the returned information so the agent knows whether it will answer the request.
Inputs28/100
11 of 30 inputs have descriptions. Add descriptions to the missing inputs, including where to obtain IDs and how to supply values.
entity › kind
Not provided
Missing description. Explain what this value means and how to supply it.
entity › identifiers › fullName
Not provided
Missing description. Explain what this value means and how to supply it.
entity › identifiers › firstName
Not provided
Missing description. Explain what this value means and how to supply it.
entity › identifiers › lastName
Not provided
Missing description. Explain what this value means and how to supply it.
entity › identifiers › email
Not provided
Missing description. Explain what this value means and how to supply it.
entity › identifiers › phone
Optional contact value. It may accompany another supported person seed but cannot be the sole enrichment identifier.
Remove validation rules already expressed in this field’s schema; describe its meaning and usage instead.
entity › identifiers › linkedinUrl
Not provided
Missing description. Explain what this value means and how to supply it.
entity › identifiers › companyName
Not provided
Missing description. Explain what this value means and how to supply it.
entity › identifiers › companyDomain
Bare company domain such as acme.com.
Remove validation rules already expressed in this field’s schema; describe its meaning and usage instead.
entity › identifiers › companyLinkedinUrl
Not provided
Missing description. Explain what this value means and how to supply it.
entity › identifiers › companyId
Not provided
Missing description. Explain what this value means and how to supply it.
entity › identifiers › personId
Vendor-specific person ID. Requires providers to contain exactly one matching adapter ID.
Remove validation rules already expressed in this field’s schema; describe its meaning and usage instead.
entity › identifiers › ipAddress
Not provided
Missing description. Explain what this value means and how to supply it.
entity › oneOf › 0 › kind
Not provided
Missing description. Explain what this value means and how to supply it.
entity › oneOf › 0 › identifiers
Not provided
Missing description. Explain what this value means and how to supply it.
entity › oneOf › 1 › kind
Not provided
Missing description. Explain what this value means and how to supply it.
entity › oneOf › 1 › identifiers
Not provided
Missing description. Explain what this value means and how to supply it.
requestedFields
For a narrow ask, list exactly the requested fields and omit profile; these fields are the stop condition.
Remove validation rules already expressed in this field’s schema; describe its meaning and usage instead.
profile
Named broad field bundle. Omit when requestedFields defines a narrow ask.
Remove validation rules already expressed in this field’s schema; describe its meaning and usage instead.
objective
Not provided
Missing description. Explain what this value means and how to supply it.
providers
Optional enrichment adapter filter. A personId requires exactly one matching adapter ID.
Remove validation rules already expressed in this field’s schema; describe its meaning and usage instead.
maxCredits
Aggregate provider-and-verification ceiling in workspace credits, not dollars. If it is below the cheapest eligible provider, the error states the minimum. Required for direct and hosted Workflow execution; set it equal to the Workflow call maxChargeCredits unless the Workflow call intentionally allows a tighter cap.
Remove validation rules already expressed in this field’s schema; describe its meaning and usage instead.
contactVerification
Require deliverability checks for discovered emails and validity, reachability, and available ownership evidence for discovered phones.
Remove validation rules already expressed in this field’s schema; describe its meaning and usage instead.
externalUserId
Not provided
Missing description. Explain what this value means and how to supply it.
attribution
Not provided
Missing description. Explain what this value means and how to supply it.
_locus › idempotency_key
Stable key making retries exactly-once.
Remove validation rules already expressed in this field’s schema; describe its meaning and usage instead.
_locus › loop_id
Stable autonomous-agent loop ID when policy requires one.
Remove validation rules already expressed in this field’s schema; describe its meaning and usage instead.
The title clearly communicates the tool’s action and subject. Keep it concise.
Description97/100
Search the live web and return a ranked, deduplicated list of sources (title, URL, snippet) merged from several search providers; no language model summarizes on this path. Use when you need links to cite or read next; use web_research for a synthesized answer and web_extract to read specific URLs. Billed per fulfilled provider call; mode fast, balanced, or comprehensive sets provider breadth and cost, and maxCredits caps the total. rails and strategy are legacy fields; prefer mode. Usually costs ~13.75 credits per call. The result reports credits charged.
The description explains the capability, when to use it, and what to expect.
Inputs36/100
9 of 19 inputs have descriptions. Add descriptions to the missing inputs, including where to obtain IDs and how to supply values.
query
Search or research request.
Remove validation rules already expressed in this field’s schema; describe its meaning and usage instead.
maxResults
Not provided
Missing description. Explain what this value means and how to supply it.
mode
Not provided
Missing description. Explain what this value means and how to supply it.
maxProviders
Not provided
Missing description. Explain what this value means and how to supply it.
strategy
Legacy mode selector retained for compatible clients.
Remove validation rules already expressed in this field’s schema; describe its meaning and usage instead.
topic
Not provided
Missing description. Explain what this value means and how to supply it.
recencyDays
Not provided
Missing description. Explain what this value means and how to supply it.
country
Not provided
Missing description. Explain what this value means and how to supply it.
includeDomains
Not provided
Missing description. Explain what this value means and how to supply it.
excludeDomains
Not provided
Missing description. Explain what this value means and how to supply it.
includeImages
Not provided
Missing description. Explain what this value means and how to supply it.
providers
Not provided
Missing description. Explain what this value means and how to supply it.
maxCredits
Aggregate hard charge ceiling in workspace credits. Decimal strings support up to six fractional digits; numeric values are rounded down to six digits.
Remove validation rules already expressed in this field’s schema; describe its meaning and usage instead.
rails
Legacy access-path field retained for compatible clients.
Remove validation rules already expressed in this field’s schema; describe its meaning and usage instead.
externalUserId
Optional end-user billing attribution for a tenant secret key.
Remove validation rules already expressed in this field’s schema; describe its meaning and usage instead.
attribution
Optional JSON ledger metadata such as a task or customer identifier.
Remove validation rules already expressed in this field’s schema; describe its meaning and usage instead.
_locus › idempotency_key
Stable key making retries exactly-once.
Remove validation rules already expressed in this field’s schema; describe its meaning and usage instead.
_locus › loop_id
Stable autonomous-agent loop ID when policy requires one.
Remove validation rules already expressed in this field’s schema; describe its meaning and usage instead.
The title clearly communicates the tool’s action and subject. Keep it concise.
Description94/100
Read the full content of one to twenty exact public URLs you already have and return each page's text, or structured JSON via json. Use after a search produced URLs or when the user supplies links; it never searches or substitutes other pages, so use router_web_search or web_research to find sources first. Billed per URL; maxCredits caps the total. In text mode a second extractor retries only the URLs the first one fails; json mode uses a single extractor with no retry. Usually costs ~4 credits per call. The result reports credits charged.
The description explains the capability, when to use it, and what to expect.
Inputs58/100
9 of 12 inputs have descriptions. Add descriptions to the missing inputs, including where to obtain IDs and how to supply values.
urls
Exact public HTTP(S) resources to read. The router never substitutes another URL.
Remove validation rules already expressed in this field’s schema; describe its meaning and usage instead.
objective
Optional focus within each supplied resource; it does not authorize discovery.
Remove validation rules already expressed in this field’s schema; describe its meaning and usage instead.
maxCharactersPerUrl
Not provided
Missing description. Explain what this value means and how to supply it.
maxAgeSeconds
Maximum accepted cache age. Omit to use each extractor default.
Clear enough to supply this argument.
json › prompt
Not provided
Missing description. Explain what this value means and how to supply it.
json › schema
Not provided
Missing description. Explain what this value means and how to supply it.
maxCredits
Aggregate hard charge ceiling in workspace credits. Decimal strings support up to six fractional digits; numeric values are rounded down to six digits.
Remove validation rules already expressed in this field’s schema; describe its meaning and usage instead.
externalUserId
Optional end-user billing attribution for a tenant secret key.
Remove validation rules already expressed in this field’s schema; describe its meaning and usage instead.
attribution
Optional JSON ledger metadata such as a task or customer identifier.
Remove validation rules already expressed in this field’s schema; describe its meaning and usage instead.
_locus › idempotency_key
Stable key making retries exactly-once.
Remove validation rules already expressed in this field’s schema; describe its meaning and usage instead.
_locus › loop_id
Stable autonomous-agent loop ID when policy requires one.
Remove validation rules already expressed in this field’s schema; describe its meaning and usage instead.
The title clearly communicates the tool’s action and subject. Keep it concise.
Description94/100
Get a grounded, current answer with inline source references: Locus searches the live web, reads sources, and synthesizes the answer. Use when you need an answer, not a list of links; use router_web_search for sources only and web_extract to read URLs you already have. effort light (default, fixed price), medium, or heavy sets depth and cost; maxCredits caps the charge. Always pass effort with maxCredits or search filters, or the call takes the legacy sources-only path and returns no answer. Usually costs ~53 credits per call. The result reports credits charged.
The description explains the capability, when to use it, and what to expect.
Inputs33/100
11 of 25 inputs have descriptions. Add descriptions to the missing inputs, including where to obtain IDs and how to supply values.
query
Search or research request.
Remove validation rules already expressed in this field’s schema; describe its meaning and usage instead.
maxResults
Not provided
Missing description. Explain what this value means and how to supply it.
mode
Not provided
Missing description. Explain what this value means and how to supply it.
maxProviders
Not provided
Missing description. Explain what this value means and how to supply it.
strategy
Legacy mode selector retained for compatible clients.
Remove validation rules already expressed in this field’s schema; describe its meaning and usage instead.
topic
Not provided
Missing description. Explain what this value means and how to supply it.
recencyDays
Not provided
Missing description. Explain what this value means and how to supply it.
country
Not provided
Missing description. Explain what this value means and how to supply it.
includeDomains
Not provided
Missing description. Explain what this value means and how to supply it.
excludeDomains
Not provided
Missing description. Explain what this value means and how to supply it.
includeImages
Not provided
Missing description. Explain what this value means and how to supply it.
providers
Not provided
Missing description. Explain what this value means and how to supply it.
maxCredits
Aggregate hard charge ceiling in workspace credits. Decimal strings support up to six fractional digits; numeric values are rounded down to six digits.
Remove validation rules already expressed in this field’s schema; describe its meaning and usage instead.
rails
Legacy access-path field retained for compatible clients.
Remove validation rules already expressed in this field’s schema; describe its meaning and usage instead.
externalUserId
Optional end-user billing attribution for a tenant secret key.
Remove validation rules already expressed in this field’s schema; describe its meaning and usage instead.
attribution
Optional JSON ledger metadata such as a task or customer identifier.
Remove validation rules already expressed in this field’s schema; describe its meaning and usage instead.
effort
Grounded answer tier. Defaults to light, priced up front. Without effort, maxCredits or search filters such as includeDomains keep the legacy evidence-only contract.
Remove validation rules already expressed in this field’s schema; describe its meaning and usage instead.
outputSchema › type
Not provided
Missing description. Explain what this value means and how to supply it.
outputSchema
Not provided
Missing description. Explain what this value means and how to supply it.
outputSchema › required
Declared properties omitted here are optional.
Remove validation rules already expressed in this field’s schema; describe its meaning and usage instead.
outputSchema › additionalProperties
Not provided
Missing description. Explain what this value means and how to supply it.
outputSchema › description
Not provided
Missing description. Explain what this value means and how to supply it.
_locus › idempotency_key
Stable key making retries exactly-once.
Remove validation rules already expressed in this field’s schema; describe its meaning and usage instead.
_locus › loop_id
Stable autonomous-agent loop ID when policy requires one.
Remove validation rules already expressed in this field’s schema; describe its meaning and usage instead.
Locus Pro API tools setup, tools, quality score, publishing readiness, and alternatives.
How do I add Locus Pro API tools to Claude, ChatGPT, or Cursor?
Add Locus Pro API tools to Claude, ChatGPT, or Cursor by connecting its remote MCP URL in each client's MCP settings. In Claude, add a custom connector. In ChatGPT, add an MCP app. In Cursor, add an MCP server under Settings. The MCP URL is https://api.stage.paywithlocus.com/api/credits/mcp.
Is Locus Pro API tools MCP ready for ChatGPT and Claude?
As of October 15, 2026, Locus Pro API tools scores 100/100 on Manufact's MCP publishing checklist. The scan meets ChatGPT publishing checks and meets Claude publishing checks. Passing these checks does not guarantee marketplace approval.
How clear is Locus Pro API tools's MCP tool documentation?
As of October 15, 2026, Locus Pro API tools scores 82/100 in Manufact's review of tool titles, descriptions, input and output schemas, and behavior annotations. The review covers 20 of 20 discovered tools. The quality score measures documentation clarity; runtime behavior and marketplace readiness require separate checks.
What are the best alternatives to Locus Pro API tools?
As of October 16, 2026, alternatives to Locus Pro API tools in developer-tools on the Manufact MCP catalog include Held at the Gate, Speko, turva.dev, AgentMail, and Celesto Cloud Computers.
How can Locus Pro API tools improve its MCP documentation?
gtm_enrich is the lowest-scoring reviewed tool at 71/100. 11 of 30 inputs have descriptions. Add descriptions to the missing inputs, including where to obtain IDs and how to supply values. Open its review for feedback and a copyable fix prompt, then rerun the documentation review after updating your tool metadata.
Not your MCP?
Review any public or OAuth MCP server for protocol compatibility, tool documentation, and ChatGPT and Claude publishing readiness. No account required.
