MCP · API 연결

이 위키는 사람이 읽는 화면과 같은 내용을 기계가 읽을 수 있는 통로로도 냅니다. 모두 공개 문서만 내주는 읽기 전용이라 열쇠가 필요 없습니다.

MCP 서버

언어모델이 이 위키를 도구로 직접 조회합니다. Streamable HTTP 방식이고 주소는 하나입니다.

https://wiki.tokenpost.kr/api/mcp

Claude Code

claude mcp add --transport http tokenpost-wiki https://wiki.tokenpost.kr/api/mcp

Claude Desktop · 그 밖의 MCP 클라이언트

설정 파일에 아래를 넣습니다.

{
  "mcpServers": {
    "tokenpost-wiki": {
      "type": "http",
      "url": "https://wiki.tokenpost.kr/api/mcp"
    }
  }
}

도구 여섯 가지

search_wiki이름으로 문서를 찾는다. 한글명·영문명·심볼·슬러그 모두 걸린다

get_doc슬러그로 문서 전문을 마크다운으로 가져온다

list_namespace이름공간(코인·용어·인물·이슈)의 문서 목록

get_timeline문서의 연표를 연도순으로. 출처가 함께 온다

get_backlinks이 문서를 가리키는 다른 문서들

wiki_overview위키 규모와 중심 문서. 무엇부터 볼지 정할 때

JSON API

프로그램에서 바로 부를 수 있습니다. 모든 응답에 CORS 가 열려 있어 브라우저에서도 됩니다.

GET /api/search?q=비트 코인&limit=20문서 검색. 띄어쓰기가 어긋나도 걸린다 — '비트 코인'과 '비트코인'이 같은 결과를 준다

GET /api/doc/ethereum문서 하나를 구조로. 요약·본문·연표·출처·업비트·투자 정보가 들어 있다

GET /api/doc/ethereum?format=markdown같은 문서를 마크다운 한 덩어리로

GET /api/stats문서·연표·연결 수와 가장 많이 참조되는 문서

GET /md/ethereum문서의 마크다운 판본. 인용하기 좋게 다듬어져 있다

GET /llms.txt언어모델용 위키 안내

GET /sitemap.xml전체 문서 주소

맛보기

curl 'https://wiki.tokenpost.kr/api/search?q=스테이킹'
curl 'https://wiki.tokenpost.kr/api/doc/ethereum' | jq .summary

마크다운으로 받기

문서 주소의 /w/ 를 /md/ 로 바꾸거나, 같은 주소에 Accept: text/markdown 헤더를 붙이면 됩니다. 답변 엔진이 HTML 에서 본문을 추려내다 실패하는 일을 막으려고 둔 통로입니다.

curl -H 'Accept: text/markdown' https://wiki.tokenpost.kr/w/ethereum

인용할 때

문서 상당수가 봇이 쓴 초안이며 사람의 검수를 거치지 않았습니다. 응답에 status 와 notice 가 그 사실을 담고 있으니, 인용하실 때 함께 밝혀 주시면 좋겠습니다. 각 문서에는 출처가 각주로 달려 있습니다.

문서를 고치는 통로

기사를 담고 문서를 만들고 고치는 내부 쓰기 API 도 있습니다. 열쇠가 있어야 하고, 고친 것은 모두 문서의 역사 탭에 남습니다. 토큰포스트 기사 번호만 적으면 각주가 자동으로 채워집니다. 쓰는 법은 저장소의 docs/INTERNAL-API.md 에 적어 두었습니다.

쓰는 데 드는 값

무료입니다. 다만 한 통로를 지나치게 몰아치면 다른 이용자가 느려지니, 초당 몇 건 정도로 여유를 두고 불러 주세요. 대량으로 훑어야 한다면 사이트맵을 받아 필요한 문서만 고르시는 편이 서로에게 낫습니다.