Meta API

2026-10-20

Meta API
健康检查
搜索方法
读取方法

Meta API

接入

加载中…

端点

方法	路径	说明	支持
GET	`/v1/health`	健康检查	● 支持
GET	`/v1/methods`	搜索方法	● 支持
GET	`/v1/methods/{name}`	读取方法	● 支持

与官方的差异

本面是平台自描述面，不对应任何第三方官方 API；healthCheck 与方法目录都无需鉴权，healthCheck 返回纯文本 ok。
搜索方法：非空 q 按方法名、摘要和描述的相关度搜索，词序和大小写不影响匹配；limit 为 1 到 50 的整数，默认 20。不带 q 或 q 全为空白时按方法名排序列出，limit 为 1 到 200 的整数，默认 50；has_more 为 true 时将 last_id 原样作为 after_id 取下一页。搜索时忽略 after_id。limit 越界返回 400 INVALID_PARAMS。目录只包含平台方法（praxis.*），不含会话里的 MCP 工具。
读取方法：name 取自搜索结果，必须与方法名完全一致。声明不会被截断，字段名和枚举值请直接从中复制。未知名称返回 404 METHOD_NOT_FOUND，hint 列出最多三个相近的名称。

Meta 是平台自描述面：/meta/v1/openapi.yaml 返回当前环境的完整 OpenAPI 规范，参数与字段以它为准。

错误按 problem+json 格式返回，参见错误；额度与响应头参见限流。

健康检查

GET /meta/v1/health● 支持

200

错误按 problem+json 格式返回，参见错误码

响应

HTTP 200

The API edge is up; the body is the plain text `ok`.

text/plain

名称	类型	说明
$	string	Always the literal `ok`.

搜索方法

GET /meta/v1/methods● 支持

请求参数

qstring可选
query: Words to look for, for example `list agents` or `create table`. Matched against method name, summary and description; every word must match when the query has two words or fewer, otherwise at least 60% of them. Omit to list methods without ranking.
limitinteger可选
默认 50
query: Maximum methods returned. Without q, defaults to 50 and accepts 1–200. Search with q defaults to 20 and accepts 1–50. Out-of-range values return 400 INVALID_PARAMS.
after_idstring可选
query: Return names lexically after this method name, usually last_id from the previous page. Ignored when q is present. An empty or expired cursor still uses lexical ordering.

200

非空 q 按方法名、摘要和描述的相关度搜索，词序和大小写不影响匹配；limit 为 1 到 50 的整数，默认 20。不带 q 或 q 全为空白时按方法名排序列出，limit 为 1 到 200 的整数，默认 50；has_more 为 true 时将 last_id 原样作为 after_id 取下一页。搜索时忽略 after_id。limit 越界返回 400 INVALID_PARAMS。目录只包含平台方法（praxis.*），不含会话里的 MCP 工具。

错误按 problem+json 格式返回，参见错误码

响应

HTTP 200

Matching methods, best match first. An empty `data` array means nothing matched; try fewer or different words.

application/json

名称	类型	说明
has_more	boolean	Present without q; true when another page follows.
first_id	string \| null	Present without q; first method name in this page, or null for an empty page.
last_id	string \| null	Present without q; last method name in this page, or null for an empty page. Pass as after_id to continue.
data	array<object>	Matching methods ordered by relevance for search, or by name for unranked listing.
data[].params	string	Compact argument list grouped by location, for example `path: database_id, table · query: select, order · body`. A trailing `` marks a required argument; `body` stands for the JSON request body. Call `GET /meta/v1/methods/{name}` for each argument's type and description.
data[].name	string	Method name such as `praxis.agent.agents.list`. Pass it to `GET /meta/v1/methods/{name}` and call it as `await praxis.agent.agents.list(args)` in codemode or an automation script.
data[].summary	string	One-line statement of what the method does.
data[].http	string	HTTP verb the method sends, for example GET or POST.
data[].path	string	Public API path template the method calls, with `{param}` placeholders filled from `args.path`.

读取方法

GET /meta/v1/methods/{name}● 支持

请求参数

namestring必填
path: Exact method name from the search results, for example `praxis.database.databases.tables.create`.

200

name 取自搜索结果，必须与方法名完全一致。声明不会被截断，字段名和枚举值请直接从中复制。未知名称返回 404 METHOD_NOT_FOUND，hint 列出最多三个相近的名称。

错误按 problem+json 格式返回，参见错误码

响应

HTTP 200

The method with its complete declaration.

application/json

名称	类型	说明
name	string	Method name, for example `praxis.agent.agents.list`.
summary	string	One-line statement of what the method does.
description	string	Full guidance for the method from the API reference, including when to use it, limits and error behaviour. May be empty for methods documented only by summary.
http	string	HTTP verb the method sends.
path	string	Public API path template with `{param}` placeholders.
declaration	string	Complete TypeScript signature, `name(args): Promise<Result>`. `args` carries `path`, `query`, `headers` and `body` members exactly as declared. Never truncated.
parameters	array<object>	Path, query and header parameters of the operation.
parameters[].name	string	Parameter name as sent on the wire.
parameters[].in	string	Where the parameter goes, one of `path`, `query` or `header`; maps to the matching member of `args`.
parameters[].required	boolean	Whether the call is rejected when the parameter is missing.
parameters[].description	string	Meaning, format and allowed values of the parameter.
parameters[].type	string	TypeScript type of the parameter value.
request_body	object	Request body expectations; null when the method takes no body.
request_body.required	boolean	Whether `args.body` must be supplied.
request_body.description	string	What the body carries.
request_body.content_types	array<string>	Media types the body may use; the first is the default.
responses	array<object>	Documented responses, successful and failed.
responses[].status	string	HTTP status code or `default`.
responses[].description	string	What the response means and what to do next.
responses[].content_types	array<string>	Media types the response may use.