ডেভেলপার API
REST বা MCP দিয়ে প্রকল্প, লক্ষ্য, পরীক্ষা, সময়সূচি ও নিজের প্রোভাইডার পরিচয়পত্র পরিচালনা করুন।
OpenAPI 3.1 JSON · অপারেশন · ত্রুটি · MCP
পরিচয় যাচাই
বর্তমান পাসওয়ার্ড দিয়ে API ও MCP-তে মেয়াদযুক্ত টোকেন তৈরি করুন। একবার কপি করে গোপন রাখুন। প্রতি অনুরোধে Authorization: Bearer TOKEN ও Accept: application/json পাঠান। সেশন কুকি এই API-তে পরিচয় যাচাই করতে পারে না। প্রত্যাহার সঙ্গে সঙ্গে কার্যকর। অ্যাকাউন্ট সক্রিয় ও ইমেইল যাচাইকৃত হতে হবে। API-তে প্রশাসকের ব্যবহারকারী হিসেবে প্রবেশ নেই।
curl 'https://serpo.one/api/v1/projects' \ -H 'Authorization: Bearer TOKEN' -H 'Accept: application/json'
সফল JSON {"data": ...}-এর মধ্যে থাকে। সংগ্রহ data-র ভিতরে Laravel পেজিনেশন ব্যবহার করে: data.data, data.current_page, data.last_page, data.total। page ≥ 1 এবং per_page 1 থেকে 100 রাখুন (ডিফল্ট 25)। অন্য অ্যাকাউন্টের ID-তে 404 আসে। গোপন তথ্য শুধু পরিচয়পত্র PUT-এ নেওয়া হয়, কখনো ফেরত দেওয়া হয় না। ব্যালেন্স ক্যাশ থাকে; রিফ্রেশ সীমিত ব্যাকগ্রাউন্ড কাজ সারিতে রাখে।
সশুল্ক পরীক্ষা ও পুনরায় চেষ্টা
রান তৈরিতে confirm_paid: true এবং অনন্য Idempotency-Key হেডার বা idempotency_key ফিল্ড লাগে। নতুন রান ছাড়া প্রতিক্রিয়া ফিরে পেতে একই কী ও হুবহু বডি দিন; একই কীতে বদলানো ইনপুটে 409 আসে। কী অ্যাকাউন্টের এবং অ্যাকাউন্ট মোছা পর্যন্ত থাকে। লক্ষ্য ও সেটিং স্থির হয়। প্রোভাইডার খরচ নিতে পারে; অনিশ্চিত অনুরোধ আবার চালাতে retry_uncertain: true দিয়ে সম্ভাব্য দ্বিগুণ খরচ স্বীকার করতে হবে। সময়সূচি তৈরিতেও confirm_paid: true ও ইডেমপোটেন্সি কী লাগে।
curl -X POST 'https://serpo.one/api/v1/projects/1/runs' \
-H 'Authorization: Bearer TOKEN' -H 'Content-Type: application/json' \
-H 'Accept: application/json' -H 'Idempotency-Key: check-2026-11-20-001' \
-d '{"confirm_paid":true,"settings":{"depth":10}}'
CSV এক্সপোর্ট পৃষ্ঠায় ভাগ করা; X-Total-Pages পৃষ্ঠার সংখ্যা দেয়। সম্পূর্ণ এক্সপোর্টে প্রতিটি পৃষ্ঠা নিন। সূত্রের মতো সেল এস্কেপ করা হয়। তারিখ ISO 8601 UTC-তে; সময়সূচিতে স্পষ্ট IANA সময় অঞ্চল লাগে। ISO দিন সোমবার=1 থেকে রবিবার=7। দিবালোক সংরক্ষণে অনুপস্থিত বা দ্ব্যর্থক পুনরাবৃত্ত সময় বাদ যায়; একবারের দ্ব্যর্থক সময়ে স্পষ্ট অফসেট লাগে।
অপারেশন
GET /api/v1/frequency — frequency.list
অনুমতি: frequency:read
POST /api/v1/frequency — frequency.create
অনুমতি: frequency:write
{
"type": "object",
"properties": {
"queries": {
"type": "array",
"items": {
"type": "string",
"maxLength": 400
},
"minItems": 1,
"maxItems": 1000
},
"project": {
"type": "integer",
"minimum": 1
},
"keyword_ids": {
"type": "array",
"items": {
"type": "integer",
"minimum": 1
},
"minItems": 1,
"maxItems": 1000,
"uniqueItems": true
},
"provider": {
"enum": [
"xmlriver",
"xmlstock"
]
},
"modes": {
"type": "array",
"items": {
"enum": [
"broad",
"phrase",
"exact"
]
},
"minItems": 1,
"maxItems": 3,
"uniqueItems": true
},
"region": {
"type": [
"integer",
"null"
],
"minimum": 0,
"maximum": 2147483647
},
"device": {
"enum": [
"all",
"desktop",
"phone",
"tablet"
]
},
"period": {
"enum": [
"month",
"week",
"day"
]
},
"start": {
"type": [
"string",
"null"
],
"format": "date"
},
"end": {
"type": [
"string",
"null"
],
"format": "date"
},
"threads": {
"type": "integer",
"minimum": 1,
"maximum": 10
},
"confirm_paid": {
"type": "boolean",
"const": true
},
"idempotency_key": {
"type": "string",
"maxLength": 100,
"pattern": "^[a-zA-Z0-9._:-]+$"
}
},
"required": [
"modes",
"confirm_paid"
],
"additionalProperties": false
}GET /api/v1/frequency/{batch} — frequency.show
অনুমতি: frequency:read
GET /api/v1/frequency/{batch}/results — frequency.results
অনুমতি: frequency:read
GET /api/v1/frequency/{batch}/export — frequency.export
অনুমতি: frequency:read
POST /api/v1/frequency/{batch}/cancel — frequency.cancel
অনুমতি: frequency:write
POST /api/v1/frequency/{batch}/retry — frequency.retry
অনুমতি: frequency:write
{
"type": "object",
"properties": {
"confirm_paid": {
"type": "boolean",
"const": true
},
"retry_uncertain": {
"type": "boolean",
"const": true
},
"idempotency_key": {
"type": "string",
"maxLength": 100,
"pattern": "^[a-zA-Z0-9._:-]+$"
}
},
"required": [
"confirm_paid"
],
"additionalProperties": false
}POST /api/v1/account/password — account.password
অনুমতি: account:write
{
"type": "object",
"properties": {
"current_password": {
"type": "string",
"maxLength": 72,
"writeOnly": true
},
"password": {
"type": "string",
"maxLength": 72,
"writeOnly": true,
"minLength": 12
},
"password_confirmation": {
"type": "string",
"maxLength": 72,
"writeOnly": true
},
"revoke_other_tokens": {
"type": "boolean",
"default": false
}
},
"required": [
"current_password",
"password",
"password_confirmation"
],
"additionalProperties": false
}GET /api/v1/tokens — tokens.list
অনুমতি: tokens:read
POST /api/v1/tokens — tokens.issue
অনুমতি:
{
"type": "object",
"properties": {
"email": {
"type": "string",
"format": "email",
"maxLength": 255
},
"password": {
"type": "string",
"maxLength": 72,
"writeOnly": true
},
"name": {
"type": "string",
"maxLength": 100
},
"abilities": {
"type": "array",
"items": {
"enum": [
"account:read",
"account:write",
"admin:read",
"admin:write",
"frequency:read",
"frequency:write",
"nullable|regex:/^[+-]\\d{2}:\\d{2}$/",
"nullable|string|max:2048",
"projects:read",
"projects:write",
"providers:read",
"providers:write",
"required|array|min:1|max:100",
"required|array|min:1|max:1000",
"required|array|min:1|max:20",
"required|integer|min:1|distinct",
"required|integer|min:1|max:365",
"required|string|max:100",
"required|string|max:30",
"required|string|max:400",
"runs:read",
"runs:write",
"schedules:read",
"schedules:write",
"sometimes|array|min:1|max:100",
"sometimes|integer|min:1|max:100",
"sometimes|integer|min:1|max:100000",
"sometimes|nullable|string|max:255",
"sometimes|required|string|max:120",
"tokens:read",
"tokens:write"
]
},
"minItems": 1,
"maxItems": 20,
"uniqueItems": true
},
"expires_in_days": {
"type": "integer",
"minimum": 1,
"maximum": 365
}
},
"required": [
"email",
"password",
"name",
"abilities",
"expires_in_days"
],
"additionalProperties": false
}DELETE /api/v1/tokens/{token} — tokens.revoke
অনুমতি: tokens:write
GET /api/v1/admin/settings — admin.settings
অনুমতি: admin:read
PATCH /api/v1/admin/settings — admin.settings_update
অনুমতি: admin:write
{
"type": "object",
"properties": {
"enabled": {
"type": "boolean"
},
"start": {
"type": "string",
"pattern": "^([01][0-9]|2[0-3]):[0-5][0-9]$"
},
"end": {
"type": "string",
"pattern": "^([01][0-9]|2[0-3]):[0-5][0-9]$"
}
},
"required": [],
"additionalProperties": false,
"minProperties": 1
}GET /api/v1/admin/users — admin.users
অনুমতি: admin:read
GET /api/v1/admin/users/{user} — admin.user
অনুমতি: admin:read
PATCH /api/v1/admin/users/{user}/status — admin.status
অনুমতি: admin:write
{
"type": "object",
"properties": {
"is_active": {
"type": "boolean"
}
},
"required": [
"is_active"
],
"additionalProperties": false
}GET /api/v1/admin/statistics — admin.statistics
অনুমতি: admin:read
GET /api/v1/admin/users/{user}/balances — admin.balances
অনুমতি: admin:read
GET /api/v1/runs/{run}/download — runs.download
অনুমতি: runs:read
GET /api/v1/account — account.show
অনুমতি: account:read
PATCH /api/v1/account — account.update
অনুমতি: account:write
{
"type": "object",
"properties": {
"name": {
"type": "string",
"maxLength": 120
},
"locale": {
"enum": [
"en",
"ru",
"kk",
"es",
"pt",
"de",
"fr",
"it",
"pl",
"tr",
"uk",
"zh",
"ja",
"ko",
"ar",
"hi",
"id",
"vi",
"th",
"nl",
"bn",
"ur",
"fa",
"cs"
]
},
"timezone": {
"type": "string",
"maxLength": 80
},
"settings": {
"$ref": "#/components/schemas/RankSettings"
}
},
"required": [],
"additionalProperties": false
}অনুরোধের বডির উদাহরণ:
{
"locale": "en",
"timezone": "Europe/Moscow"
}GET /api/v1/projects — projects.list
অনুমতি: projects:read
POST /api/v1/projects — projects.create
অনুমতি: projects:write
{
"type": "object",
"properties": {
"name": {
"type": "string",
"maxLength": 120
},
"settings": {
"$ref": "#/components/schemas/RankSettings"
}
},
"required": [
"name"
],
"additionalProperties": false
}অনুরোধের বডির উদাহরণ:
{
"name": "Example",
"settings": {
"depth": 10
}
}GET /api/v1/projects/{project} — projects.show
অনুমতি: projects:read
PATCH /api/v1/projects/{project} — projects.update
অনুমতি: projects:write
{
"type": "object",
"properties": {
"name": {
"type": "string",
"maxLength": 120
},
"settings": {
"$ref": "#/components/schemas/RankSettings"
}
},
"required": [],
"additionalProperties": false
}DELETE /api/v1/projects/{project} — projects.delete
অনুমতি: projects:write
POST /api/v1/projects/{project}/domains/import — domains.import
অনুমতি: projects:write
{
"type": "object",
"properties": {
"format": {
"enum": [
"txt",
"csv",
"json"
]
},
"mode": {
"enum": [
"append",
"replace"
]
},
"content": {
"type": "string",
"maxLength": 2000000
}
},
"required": [
"format",
"mode",
"content"
],
"additionalProperties": false
}POST /api/v1/projects/{project}/domains/bulk-delete — domains.bulk_delete
অনুমতি: projects:write
{
"type": "object",
"properties": {
"ids": {
"type": "array",
"items": {
"type": "integer",
"minimum": 1
},
"minItems": 1,
"maxItems": 1000,
"uniqueItems": true
}
},
"required": [
"ids"
],
"additionalProperties": false
}POST /api/v1/projects/{project}/keywords/import — keywords.import
অনুমতি: projects:write
{
"type": "object",
"properties": {
"format": {
"enum": [
"txt",
"csv",
"json"
]
},
"mode": {
"enum": [
"append",
"replace"
]
},
"content": {
"type": "string",
"maxLength": 2000000
}
},
"required": [
"format",
"mode",
"content"
],
"additionalProperties": false
}POST /api/v1/projects/{project}/keywords/bulk-delete — keywords.bulk_delete
অনুমতি: projects:write
{
"type": "object",
"properties": {
"ids": {
"type": "array",
"items": {
"type": "integer",
"minimum": 1
},
"minItems": 1,
"maxItems": 1000,
"uniqueItems": true
}
},
"required": [
"ids"
],
"additionalProperties": false
}GET /api/v1/projects/{project}/domains — domains.list
অনুমতি: projects:read
POST /api/v1/projects/{project}/domains — domains.create
অনুমতি: projects:write
{
"type": "object",
"properties": {
"domain": {
"type": "string",
"maxLength": 2048
},
"group": {
"type": "string",
"maxLength": 255
}
},
"required": [
"domain"
],
"additionalProperties": false
}অনুরোধের বডির উদাহরণ:
{
"domain": "example.com"
}PATCH /api/v1/projects/{project}/domains/{item} — domains.update
অনুমতি: projects:write
{
"type": "object",
"properties": {
"domain": {
"type": "string",
"maxLength": 2048
},
"group": {
"type": "string",
"maxLength": 255
}
},
"required": [
"domain"
],
"additionalProperties": false
}DELETE /api/v1/projects/{project}/domains/{item} — domains.delete
অনুমতি: projects:write
GET /api/v1/projects/{project}/keywords — keywords.list
অনুমতি: projects:read
POST /api/v1/projects/{project}/keywords — keywords.create
অনুমতি: projects:write
{
"type": "object",
"properties": {
"query": {
"type": "string",
"maxLength": 400
},
"domain": {
"type": [
"string",
"null"
],
"maxLength": 2048
},
"group": {
"type": "string",
"maxLength": 255
}
},
"required": [
"query"
],
"additionalProperties": false
}অনুরোধের বডির উদাহরণ:
{
"query": "example search",
"group": "Primary"
}PATCH /api/v1/projects/{project}/keywords/{item} — keywords.update
অনুমতি: projects:write
{
"type": "object",
"properties": {
"query": {
"type": "string",
"maxLength": 400
},
"domain": {
"type": [
"string",
"null"
],
"maxLength": 2048
},
"group": {
"type": "string",
"maxLength": 255
}
},
"required": [
"query"
],
"additionalProperties": false
}DELETE /api/v1/projects/{project}/keywords/{item} — keywords.delete
অনুমতি: projects:write
GET /api/v1/providers — providers.list
অনুমতি: providers:read
PUT /api/v1/providers/{provider}/credentials — credentials.put
অনুমতি: providers:write
{
"type": "object",
"properties": {
"provider_user": {
"type": "string",
"maxLength": 255,
"writeOnly": true
},
"api_key": {
"type": "string",
"maxLength": 2000,
"writeOnly": true
},
"frequency_api_key": {
"type": "string",
"maxLength": 2000,
"writeOnly": true,
"deprecated": true,
"description": "Deprecated compatibility alias for api_key for both providers; conflicting values return 422."
},
"balance_api_key": {
"type": "string",
"maxLength": 2000,
"writeOnly": true,
"deprecated": true,
"description": "Deprecated compatibility alias for api_key for both providers; conflicting values return 422; never returned."
}
},
"required": [],
"additionalProperties": false,
"description": "Both XMLRiver and XMLStock use one api_key for SERP, Wordstat and balance. Legacy frequency_api_key and balance_api_key are aliases only; conflicting values and masked placeholders return 422. Blank or omitted keys preserve the saved primary key. provider_user is required for first connection; blank or omitted provider_user preserves the saved ID. Masked IDs are rejected."
}অনুরোধের বডির উদাহরণ:
{
"provider_user": "123",
"api_key": "REPLACE_WITH_PROVIDER_KEY"
}DELETE /api/v1/providers/{provider}/credentials — credentials.delete
অনুমতি: providers:write
GET /api/v1/balances — balances.list
অনুমতি: providers:read
POST /api/v1/balances/refresh — balances.refresh
অনুমতি: providers:write
GET /api/v1/runs — runs.list
অনুমতি: runs:read
POST /api/v1/projects/{project}/runs — runs.create
অনুমতি: runs:write
{
"type": "object",
"properties": {
"confirm_paid": {
"type": "boolean",
"const": true
},
"idempotency_key": {
"type": "string",
"maxLength": 100,
"pattern": "^[a-zA-Z0-9._:-]+$"
},
"settings": {
"$ref": "#/components/schemas/RankSettings"
},
"keyword_id": {
"type": "integer",
"minimum": 1
},
"domain_ids": {
"type": "array",
"items": {
"type": "integer",
"minimum": 1
},
"minItems": 1,
"maxItems": 100,
"uniqueItems": true
}
},
"required": [
"confirm_paid"
],
"additionalProperties": false
}অনুরোধের বডির উদাহরণ:
{
"confirm_paid": true,
"idempotency_key": "check-001",
"settings": {
"depth": 10
}
}GET /api/v1/runs/{run} — runs.show
অনুমতি: runs:read
GET /api/v1/runs/{run}/results — runs.results
অনুমতি: runs:read
GET /api/v1/runs/{run}/export — runs.export
অনুমতি: runs:read
POST /api/v1/runs/{run}/pause — runs.pause
অনুমতি: runs:write
POST /api/v1/runs/{run}/resume — runs.resume
অনুমতি: runs:write
{
"type": "object",
"properties": {
"retry_uncertain": {
"type": "boolean",
"const": true
}
},
"required": [],
"additionalProperties": false
}অনুরোধের বডির উদাহরণ:
{
"retry_uncertain": true
}POST /api/v1/runs/{run}/cancel — runs.cancel
অনুমতি: runs:write
GET /api/v1/schedules — schedules.list
অনুমতি: schedules:read
POST /api/v1/schedules — schedules.create
অনুমতি: schedules:write
{
"type": "object",
"properties": {
"project_ids": {
"type": "array",
"items": {
"type": "integer",
"minimum": 1
},
"minItems": 1,
"maxItems": 100,
"uniqueItems": true
},
"domain_ids": {
"type": "object",
"additionalProperties": {
"type": "array",
"items": {
"type": "integer",
"minimum": 1
},
"minItems": 1,
"maxItems": 100,
"uniqueItems": true
}
},
"settings": {
"$ref": "#/components/schemas/RankSettings"
},
"frequency": {
"enum": [
"daily",
"weekly"
]
},
"weekdays": {
"type": "array",
"items": {
"type": "integer",
"minimum": 1,
"maximum": 7
},
"uniqueItems": true
},
"local_time": {
"type": "string",
"pattern": "^\\d{2}:\\d{2}$"
},
"timezone": {
"type": "string",
"maxLength": 80
},
"enabled": {
"type": "boolean"
},
"confirm_paid": {
"type": "boolean",
"const": true
},
"idempotency_key": {
"type": "string",
"maxLength": 100,
"pattern": "^[a-zA-Z0-9._:-]+$"
}
},
"required": [
"project_ids",
"frequency",
"local_time",
"timezone",
"confirm_paid"
],
"additionalProperties": false
}অনুরোধের বডির উদাহরণ:
{
"idempotency_key": "schedule-001",
"project_ids": [
1
],
"frequency": "weekly",
"weekdays": [
1,
3,
5
],
"local_time": "09:00",
"timezone": "Europe/Moscow",
"enabled": true,
"confirm_paid": true
}GET /api/v1/schedules/once — schedules.once_list
অনুমতি: schedules:read
POST /api/v1/schedules/once — schedules.once
অনুমতি: schedules:write
{
"type": "object",
"properties": {
"project_ids": {
"type": "array",
"items": {
"type": "integer",
"minimum": 1
},
"minItems": 1,
"maxItems": 100,
"uniqueItems": true
},
"settings": {
"$ref": "#/components/schemas/RankSettings"
},
"scheduled_for": {
"type": "string",
"maxLength": 30
},
"timezone": {
"type": "string",
"maxLength": 80
},
"offset": {
"type": "string",
"pattern": "^[+-]\\d{2}:\\d{2}$"
},
"confirm_paid": {
"type": "boolean",
"const": true
},
"idempotency_key": {
"type": "string",
"maxLength": 100,
"pattern": "^[a-zA-Z0-9._:-]+$"
}
},
"required": [
"project_ids",
"scheduled_for",
"timezone",
"confirm_paid"
],
"additionalProperties": false
}অনুরোধের বডির উদাহরণ:
{
"idempotency_key": "once-001",
"project_ids": [
1
],
"scheduled_for": "2027-01-20T09:00",
"timezone": "Europe/Moscow",
"confirm_paid": true
}GET /api/v1/schedules/once/{schedule} — schedules.once_show
অনুমতি: schedules:read
PATCH /api/v1/schedules/once/{schedule} — schedules.once_update
অনুমতি: schedules:write
{
"type": "object",
"properties": {
"scheduled_for": {
"type": "string",
"maxLength": 30
},
"timezone": {
"type": "string",
"maxLength": 80
},
"offset": {
"type": "string",
"pattern": "^[+-]\\d{2}:\\d{2}$"
}
},
"required": [
"scheduled_for",
"timezone"
],
"additionalProperties": false
}DELETE /api/v1/schedules/once/{schedule} — schedules.once_delete
অনুমতি: schedules:write
GET /api/v1/schedules/{schedule} — schedules.show
অনুমতি: schedules:read
PATCH /api/v1/schedules/{schedule} — schedules.update
অনুমতি: schedules:write
{
"type": "object",
"properties": {
"project_ids": {
"type": "array",
"items": {
"type": "integer",
"minimum": 1
},
"minItems": 1,
"maxItems": 100,
"uniqueItems": true
},
"domain_ids": {
"type": "object",
"additionalProperties": {
"type": "array",
"items": {
"type": "integer",
"minimum": 1
},
"minItems": 1,
"maxItems": 100,
"uniqueItems": true
}
},
"settings": {
"$ref": "#/components/schemas/RankSettings"
},
"frequency": {
"enum": [
"daily",
"weekly"
]
},
"weekdays": {
"type": "array",
"items": {
"type": "integer",
"minimum": 1,
"maximum": 7
},
"uniqueItems": true
},
"local_time": {
"type": "string",
"pattern": "^\\d{2}:\\d{2}$"
},
"timezone": {
"type": "string",
"maxLength": 80
},
"enabled": {
"type": "boolean"
},
"confirm_paid": {
"type": "boolean",
"const": true
},
"idempotency_key": {
"type": "string",
"maxLength": 100,
"pattern": "^[a-zA-Z0-9._:-]+$"
}
},
"required": [],
"additionalProperties": false
}DELETE /api/v1/schedules/{schedule} — schedules.delete
অনুমতি: schedules:write
GET /api/v1/healthz — health.show
অনুমতি:
ত্রুটি ও সীমা
401: Bearer টোকেন নেই, মেয়াদ শেষ বা প্রত্যাহার করা। 403: অনুমতি কম বা অ্যাকাউন্ট নিষ্ক্রিয়/অযাচাইকৃত। 404: রিসোর্স অনুপলব্ধ, অন্য অ্যাকাউন্টের রিসোর্সও। 409: ইডেমপোটেন্সি দ্বন্দ্ব। 422: ইনপুট অবৈধ; errors ফিল্ড অনুযায়ী থাকে। 429: অনুরোধের সীমা পেরিয়েছে; Retry-After মানুন ও বিরতি বাড়ান। প্রতিক্রিয়া হারিয়েছে বলে সশুল্ক পুনঃচেষ্টায় নতুন ইডেমপোটেন্সি কী দেবেন না।
{"message":"The name field is required.","errors":{"name":["The name field is required."]}}
MCP
একই Bearer টোকেন দিয়ে Streamable HTTP-তে /mcp যুক্ত করুন। tools/list থেকে সঠিক টুল স্কিমা জানুন। নাম ওপরের অপারেশন ID অনুযায়ী; runs.start মানে runs.create। প্রোভাইডারের গোপন তথ্য ও টোকেন প্রশাসন MCP-তে নেই; অ্যাকাউন্ট বা পরিচয়পত্র REST এন্ডপয়েন্ট ব্যবহার করুন। পড়া ও লেখার অনুমতি আলাদা। সশুল্ক তৈরিতে সম্মতি ও ইডেমপোটেন্সি কী লাগে। পরিচয়পত্র কখনো ফেরত দেওয়া হয় না। MCP ক্লায়েন্টের তথ্য বদলানোর দরকার হলেই লেখার অনুমতি দিন।
curl -X POST 'https://serpo.one/mcp' \
-H 'Authorization: Bearer TOKEN' -H 'Content-Type: application/json' \
-H 'Accept: application/json, text/event-stream' \
-d '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2025-11-25","capabilities":{},"clientInfo":{"name":"my-client","version":"1.0"}}}'