curl --request GET \
--url https://api.pomerado.ai/v1/tools \
--header 'Authorization: Bearer <token>'const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api.pomerado.ai/v1/tools', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://api.pomerado.ai/v1/tools"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text){
"data": [
{
"id": "tool_0f8e2d1c4b3a49e8a7f6e5d4c3b2a190",
"name": "<string>",
"description": "<string>",
"integration_id": "int_0f8e2d1c4b3a49e8a7f6e5d4c3b2a190",
"site": {
"url": "<string>",
"name": "<string>"
},
"effect": "read",
"input_schema": {},
"output_schema": {},
"login": {
"fields": [
"username"
],
"two_factor_methods": [
"sms"
]
},
"mcp_name": "<string>"
}
],
"next_cursor": "<string>",
"possible_matches": [
{
"id": "tool_0f8e2d1c4b3a49e8a7f6e5d4c3b2a190",
"name": "<string>",
"description": "<string>",
"integration_id": "int_0f8e2d1c4b3a49e8a7f6e5d4c3b2a190",
"site": {
"url": "<string>",
"name": "<string>"
},
"effect": "read",
"input_schema": {},
"output_schema": {},
"login": {
"fields": [
"username"
],
"two_factor_methods": [
"sms"
]
},
"mcp_name": "<string>"
}
],
"notice": {
"code": "sign_in_to_see_all_tools",
"message": "<string>",
"docs_url": "<string>"
}
}{
"error": {
"code": "<string>",
"message": "<string>",
"retryable": true,
"docs_url": "<string>",
"details": {}
}
}{
"error": {
"code": "<string>",
"message": "<string>",
"retryable": true,
"docs_url": "<string>",
"details": {}
}
}{
"error": {
"code": "<string>",
"message": "<string>",
"retryable": true,
"docs_url": "<string>",
"details": {}
}
}{
"error": {
"code": "<string>",
"message": "<string>",
"retryable": true,
"docs_url": "<string>",
"details": {}
}
}{
"error": {
"code": "<string>",
"message": "<string>",
"retryable": true,
"docs_url": "<string>",
"details": {}
}
}List tools
List or search the tools you can run: public tools and your own private ones.
curl --request GET \
--url https://api.pomerado.ai/v1/tools \
--header 'Authorization: Bearer <token>'const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api.pomerado.ai/v1/tools', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://api.pomerado.ai/v1/tools"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text){
"data": [
{
"id": "tool_0f8e2d1c4b3a49e8a7f6e5d4c3b2a190",
"name": "<string>",
"description": "<string>",
"integration_id": "int_0f8e2d1c4b3a49e8a7f6e5d4c3b2a190",
"site": {
"url": "<string>",
"name": "<string>"
},
"effect": "read",
"input_schema": {},
"output_schema": {},
"login": {
"fields": [
"username"
],
"two_factor_methods": [
"sms"
]
},
"mcp_name": "<string>"
}
],
"next_cursor": "<string>",
"possible_matches": [
{
"id": "tool_0f8e2d1c4b3a49e8a7f6e5d4c3b2a190",
"name": "<string>",
"description": "<string>",
"integration_id": "int_0f8e2d1c4b3a49e8a7f6e5d4c3b2a190",
"site": {
"url": "<string>",
"name": "<string>"
},
"effect": "read",
"input_schema": {},
"output_schema": {},
"login": {
"fields": [
"username"
],
"two_factor_methods": [
"sms"
]
},
"mcp_name": "<string>"
}
],
"notice": {
"code": "sign_in_to_see_all_tools",
"message": "<string>",
"docs_url": "<string>"
}
}{
"error": {
"code": "<string>",
"message": "<string>",
"retryable": true,
"docs_url": "<string>",
"details": {}
}
}{
"error": {
"code": "<string>",
"message": "<string>",
"retryable": true,
"docs_url": "<string>",
"details": {}
}
}{
"error": {
"code": "<string>",
"message": "<string>",
"retryable": true,
"docs_url": "<string>",
"details": {}
}
}{
"error": {
"code": "<string>",
"message": "<string>",
"retryable": true,
"docs_url": "<string>",
"details": {}
}
}{
"error": {
"code": "<string>",
"message": "<string>",
"retryable": true,
"docs_url": "<string>",
"details": {}
}
}Details
Details
- Each tool has its input and output schemas, effect, sign-in needs and integration. Disabled tools are never listed.
- An integration key lists only its integration’s tools.
- Without credentials, where allowed, only public read-only tools that need no login are listed. A notice says that signing up (free) or signing in adds tools that write, saved logins and building tools, and how to do it.
- Callers: an API key, an integration’s API key, an MCP OAuth token or a Dashboard session.
-
Permission:
tools:read. - Effect: Changes nothing.
- Errors: only the errors any request can get.
Authorizations
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
Query Parameters
The next_cursor of the previous page
Items per page, 1 to 100 (default 20)
Text to look for in tool names and descriptions
Only this site's tools: instacart.com or a pasted URL
Only this integration's tools
"int_0f8e2d1c4b3a49e8a7f6e5d4c3b2a190"
Response
One page of tools
Show child attributes
Show child attributes
With query and site_url, on the first page: up to 50 of the site's other tools that may cover the task. Compare them before building another.
Show child attributes
Show child attributes
Present only without credentials: the list holds only public read-only tools that need no login. Signing up (free) or signing in shows every tool.
Show child attributes
Show child attributes