René's URL Explorer Experiment


Title: improvement(mcp): advertise server metadata, output schemas, and clearer tool docs by waleedlatif1 · Pull Request #9037 · simstudioai/sim · GitHub

Open Graph Title: improvement(mcp): advertise server metadata, output schemas, and clearer tool docs by waleedlatif1 · Pull Request #9037 · simstudioai/sim

X Title: improvement(mcp): advertise server metadata, output schemas, and clearer tool docs by waleedlatif1 · Pull Request #9037 · simstudioai/sim

Description: Summary Server initialize now advertises title, description, websiteUrl (MCP docs overview), and icons: a vector SVG (sizes: ["any"]) plus a 512px PNG fallback, served from the app's own base URL search_operations and describe_operation declare an outputSchema and return structuredContent alongside the same JSON as text, so older clients see no change Output schemas live in catalog.ts and the catalog's result types are inferred from them, so the advertised schema and the real result can't drift The call tools keep text-only results; they return whatever the chosen operation returns, so an output schema would only say unknown Clearer input docs: limit and domain on search; params, query, headers and body on the call tools now explain where values come from describe_operation says what it returns; the write tool, retitled "Write to Sim" to pair with "Read from Sim", now warns that changes apply immediately with no undo, that workflow runs can call external services and use credits, and to confirm deletions and runs first Name, version, capabilities, instructions, tool names, input constraints and annotations are unchanged Drops the now-unused jsonToolResult helper and un-exports HttpMethod, whose only outside importer was the catalog Type of Change Improvement Testing Drove the real MCP route handler with a scratch harness (not committed): initialize returns the new server info, with capabilities and instructions unchanged tools/list advertises both output schemas search_operations returned all 298 operations across every domain, and describe_operation succeeded for all 298, with no SDK output-validation errors; structuredContent matched the text content every time An unknown operation still returns a tool error lib/api/mcp + lib/knowledge/mcp vitest (85 tests), lint, check:unused-exports, check:comment-hygiene, check:source-conventions, check:explicit-any, check:utils, block-registry check Full type-check, check:audits, and the full test suite are left to CI Checklist Code follows project style guidelines Self-reviewed my changes Tests added/updated and passing (new tests pass the test-audit authoring gate) No new warnings introduced I confirm that I have read and agree to the terms outlined in the Contributor License Agreement (CLA)

Open Graph Description: Summary Server initialize now advertises title, description, websiteUrl (MCP docs overview), and icons: a vector SVG (sizes: ["any"]) plus a 512px PNG fallback, served from the app's...

X Description: Summary Server initialize now advertises title, description, websiteUrl (MCP docs overview), and icons: a vector SVG (sizes: ["any"]) plus a 512px PNG fallback, served from the a...

Opengraph URL: https://github.com/simstudioai/sim/pull/9037

X: @github

direct link

Domain: github.com

react-profiling0
react-import-mapreact,react-dom,react-dom/client,react-dom/profiling,react-is,react-reconciler,react/compiler-runtime,react/jsx-dev-runtime,react/jsx-runtime,scheduler@d5750093facf
route-pattern/:user_id/:repository/pull/:id/files(.:format)
route-controllerpull_requests
route-actionfiles
fetch-noncev2:2f6d2fe9-330f-a08c-5808-39938579c2f1
current-catalog-service-hashae870bc5e265a340912cde392f23dad3671a0a881730ffdadd82f2f57d81641b
request-idDC62:18732E:C2CF87:10B1877:6AFB5684
html-safe-nonceb6d2c17e91d44ea94bef9397b839b21855a1a9457987cd26c6005245600bab3f
visitor-payloadeyJyZWZlcnJlciI6IiIsInJlcXVlc3RfaWQiOiJEQzYyOjE4NzMyRTpDMkNGODc6MTBCMTg3Nzo2QUZCNTY4NCIsInZpc2l0b3JfaWQiOiI4Nzk3MDM4MjA0NTcwNzg1NDEyIiwicmVnaW9uX2VkZ2UiOiJpYWQiLCJyZWdpb25fcmVuZGVyIjoiaWFkIn0=
visitor-hmaca7622e101e68102475b154ab29babbc8d76f0eeda6378ffde002515c72c6a431
hovercard-subject-tagpull_request:4863890697
github-keyboard-shortcutsrepository,pull-request-list,pull-request-conversation,pull-request-files-changed,copilot
google-site-verificationApib7-x98H0j5cPqHWwSMm6dNU4GmODRoqxLiDzdx9I
octolytics-urlhttps://collector.github.com/github/collect
analytics-location///pull_requests/show/files
fb:app_id1401488693436528
apple-itunes-appapp-id=1477376905, app-argument=https://github.com/simstudioai/sim/pull/9037/files
twitter:imagehttps://avatars.githubusercontent.com/u/40672544?s=400&v=4
twitter:cardsummary_large_image
og:imagehttps://avatars.githubusercontent.com/u/40672544?s=400&v=4
og:image:altSummary Server initialize now advertises title, description, websiteUrl (MCP docs overview), and icons: a vector SVG (sizes: ["any"]) plus a 512px PNG fallback, served from the app's...
og:site_nameGitHub
og:typeobject
hostnamegithub.com
expected-hostnamegithub.com
None7122bb414b542dba14d71a3f0b9f6fd2abce715b9f5912d082800563e6c806d1
turbo-cache-controlno-preview
diff-viewunified
go-importgithub.com/simstudioai/sim git https://github.com/simstudioai/sim.git
octolytics-dimension-user_id199344406
octolytics-dimension-user_loginsimstudioai
octolytics-dimension-repository_id912559512
octolytics-dimension-repository_nwosimstudioai/sim
octolytics-dimension-repository_publictrue
octolytics-dimension-repository_is_forkfalse
octolytics-dimension-repository_network_root_id912559512
octolytics-dimension-repository_network_root_nwosimstudioai/sim
turbo-body-classeslogged-out env-production page-responsive full-width
disable-turbotrue
browser-stats-urlhttps://api.github.com/_private/browser/stats
browser-errors-urlhttps://api.github.com/_private/browser/errors
releasecbf66c024bb6d10e6955baa7413c54cf13a201bb
ui-targetfull
theme-color#1e2327
color-schemelight dark

Links:

Skip to contenthttps://github.com/simstudioai/sim/pull/9037/files#start-of-content
https://github.com/
Sign inhttps://github.com/login?return_to=https%3A%2F%2Fgithub.com%2Fsimstudioai%2Fsim%2Fpull%2F9037%2Ffiles
GitHubRepository hosting, code review, and collaborationhttps://github.com/platform
CopilotAI coding agent for tasks, projects, and automated workhttps://github.com/features/copilot
ActionsCI/CD and automationhttps://github.com/features/actions
Code QualityQuality analysis, fixes, and enforcementhttps://github.com/features/code-quality
CodespacesCloud development environmentshttps://github.com/features/codespaces
Code SecurityVulnerability detection and remediationhttps://github.com/security/advanced-security/code-security
Secret ProtectionSecret scanning and leak preventionhttps://github.com/security/advanced-security/secret-protection
All Featureshttps://github.com/features
Documentationhttps://docs.github.com/en
Traininghttps://learn.github.com/skills
Certificationshttps://learn.github.com/credentials
Build with Copilothttps://github.com/features/ai
Customize Copilothttps://docs.github.com/en/copilot/how-tos/copilot-on-github/customize-copilot/customize-copilot-overview
Integrationshttps://github.com/marketplace
Trending reposhttps://github.com/trending
GitHub Sponsorshttps://github.com/open-source/sponsors
Developer articleshttps://github.com/resources/articles
ChangelogYour source for the latest features, improvements, and fixes across GitHub products, all in one place.https://github.blog/changelog/
Enterpriseshttps://github.com/enterprise
Teamhttps://github.com/team
Startupshttps://github.com/enterprise/startups
Nonprofitshttps://github.com/solutions/industry/nonprofits
Healthcarehttps://github.com/solutions/industry/healthcare
Financial serviceshttps://github.com/solutions/industry/financial-services
Manufacturinghttps://github.com/solutions/industry/manufacturing
Governmenthttps://github.com/solutions/industry/government
See all industrieshttps://github.com/solutions/industry
Why GitHubhttps://github.com/why-github
Customer Storieshttps://github.com/customer-stories
Business insightshttps://github.com/solutions/executive-insights
Trust Centerhttps://github.com/trust-center
GitHub Advanced SecurityEnterprise-grade code securityhttps://github.com/security/advanced-security
Copilot for businessEnterprise-grade AI featureshttps://github.com/features/copilot/copilot-business
Premium SupportEnterprise-grade 24/7 supporthttps://github.com/enterprise/premium-support
Documentationhttps://docs.github.com/en
Resource centerhttps://github.com/resources
Bloghttps://github.blog/
Events & webinarshttps://github.com/resources/events
Community Forumhttps://github.com/orgs/community/discussions
Customer Storieshttps://github.com/customer-stories
Integrationshttps://github.com/marketplace
Customer supporthttps://help.github.com/
Traininghttps://learn.github.com/skills
GitHub Statushttps://www.githubstatus.com/
Abouthttps://github.com/about
Partnershttps://github.com/partners
Changeloghttps://github.blog/changelog/
GitHub UniverseThe event for developers, by developers — talks, workshops, and what’s next for GitHub.https://githubuniverse.com/
Pricinghttps://github.com/pricing
Sign inhttps://github.com/login?return_to=https%3A%2F%2Fgithub.com%2Fsimstudioai%2Fsim%2Fpull%2F9037%2Ffiles
Sign uphttps://github.com/signup?ref_cta=Sign+up&ref_loc=header+logged+out&ref_page=%2F%3Cuser-name%3E%2F%3Crepo-name%3E%2Fpull_requests%2Fshow%2Ffiles&source=header-repo&source_repo=simstudioai%2Fsim
Reloadhttps://github.com/simstudioai/sim/pull/9037/files
Reloadhttps://github.com/simstudioai/sim/pull/9037/files
Reloadhttps://github.com/simstudioai/sim/pull/9037/files
simstudioaihttps://github.com/simstudioai
simhttps://github.com/simstudioai/sim
Codehttps://github.com/simstudioai/sim
Issues129 (129)https://github.com/simstudioai/sim/issues
Pull requests197 (197)https://github.com/simstudioai/sim/pulls
Actionshttps://github.com/simstudioai/sim/actions
Projectshttps://github.com/simstudioai/sim/projects
Security and qualityhttps://github.com/simstudioai/sim/security
Insightshttps://github.com/simstudioai/sim/pulse
Sign up for GitHub https://github.com/signup?return_to=%2Fsimstudioai%2Fsim%2Fissues%2Fnew%2Fchoose
terms of servicehttps://docs.github.com/terms
privacy statementhttps://docs.github.com/privacy
Sign inhttps://github.com/login?return_to=%2Fsimstudioai%2Fsim%2Fissues%2Fnew%2Fchoose
waleedlatif1https://github.com/waleedlatif1
staginghttps://github.com/simstudioai/sim/tree/staging
improvement/mcp-server-metadatahttps://github.com/simstudioai/sim/tree/improvement/mcp-server-metadata
Conversation 2 https://github.com/simstudioai/sim/pull/9037
Commits 1 https://github.com/simstudioai/sim/pull/9037/commits
Checks 51 https://github.com/simstudioai/sim/pull/9037/checks
Files changed https://github.com/simstudioai/sim/pull/9037/files
Please reload this pagehttps://github.com/simstudioai/sim/pull/9037/files
improvement(mcp): advertise server metadata, output schemas, and clearer tool docs https://github.com/simstudioai/sim/pull/9037/files#top
Show all changes 1 commit https://github.com/simstudioai/sim/pull/9037/files
801261f improvement(mcp): advertise server metadata, output schemas, and clea… waleedlatif1 Oct 14, 2026 https://github.com/simstudioai/sim/pull/9037/commits/801261fc74121deb37640420606ac24b6f83f600
Clear filters https://github.com/simstudioai/sim/pull/9037/files
Please reload this pagehttps://github.com/simstudioai/sim/pull/9037/files
Please reload this pagehttps://github.com/simstudioai/sim/pull/9037/files
types.ts https://github.com/simstudioai/sim/pull/9037/files#diff-453cc28531ea8f9338d58ffa619a757d44610c633abedafce60e3b719882f4a2
catalog.ts https://github.com/simstudioai/sim/pull/9037/files#diff-55fa4bdbb65c053c32cf954ccef240705bb29047893f5bb6c935b3dbaf4daeee
server.ts https://github.com/simstudioai/sim/pull/9037/files#diff-7e16549ad100382b39702cea73a130a131aae8689f6a0e8186e63a7f12ea0b5d
tool-result.ts https://github.com/simstudioai/sim/pull/9037/files#diff-ff4f8d716b657c33b45e32ab5e50facdd25af842c621ae4e0b1b37b1fa2f28c8
apps/sim/lib/api/contracts/types.tshttps://github.com/simstudioai/sim/pull/9037/files#diff-453cc28531ea8f9338d58ffa619a757d44610c633abedafce60e3b719882f4a2
View file https://github.com/simstudioai/sim/blob/801261fc74121deb37640420606ac24b6f83f600/apps/sim/lib/api/contracts/types.ts
Open in desktop https://desktop.github.com
https://github.co/hiddenchars
https://github.com/simstudioai/sim/pull/9037/{{ revealButtonHref }}
https://github.com/simstudioai/sim/pull/9037/files#diff-453cc28531ea8f9338d58ffa619a757d44610c633abedafce60e3b719882f4a2
apps/sim/lib/api/mcp/catalog.tshttps://github.com/simstudioai/sim/pull/9037/files#diff-55fa4bdbb65c053c32cf954ccef240705bb29047893f5bb6c935b3dbaf4daeee
View file https://github.com/simstudioai/sim/blob/801261fc74121deb37640420606ac24b6f83f600/apps/sim/lib/api/mcp/catalog.ts
Open in desktop https://desktop.github.com
https://github.co/hiddenchars
https://github.com/simstudioai/sim/pull/9037/{{ revealButtonHref }}
https://github.com/simstudioai/sim/pull/9037/files#diff-55fa4bdbb65c053c32cf954ccef240705bb29047893f5bb6c935b3dbaf4daeee
https://github.com/simstudioai/sim/pull/9037/files#diff-55fa4bdbb65c053c32cf954ccef240705bb29047893f5bb6c935b3dbaf4daeee
https://github.com/simstudioai/sim/pull/9037/files#diff-55fa4bdbb65c053c32cf954ccef240705bb29047893f5bb6c935b3dbaf4daeee
https://github.com/simstudioai/sim/pull/9037/files#diff-55fa4bdbb65c053c32cf954ccef240705bb29047893f5bb6c935b3dbaf4daeee
apps/sim/lib/api/mcp/server.tshttps://github.com/simstudioai/sim/pull/9037/files#diff-7e16549ad100382b39702cea73a130a131aae8689f6a0e8186e63a7f12ea0b5d
View file https://github.com/simstudioai/sim/blob/801261fc74121deb37640420606ac24b6f83f600/apps/sim/lib/api/mcp/server.ts
Open in desktop https://desktop.github.com
https://github.co/hiddenchars
https://github.com/simstudioai/sim/pull/9037/{{ revealButtonHref }}
https://github.com/simstudioai/sim/pull/9037/files#diff-7e16549ad100382b39702cea73a130a131aae8689f6a0e8186e63a7f12ea0b5d
https://github.com/simstudioai/sim/pull/9037/files#diff-7e16549ad100382b39702cea73a130a131aae8689f6a0e8186e63a7f12ea0b5d
https://github.com/simstudioai/sim/pull/9037/files#diff-7e16549ad100382b39702cea73a130a131aae8689f6a0e8186e63a7f12ea0b5d
https://github.com/simstudioai/sim/pull/9037/files#diff-7e16549ad100382b39702cea73a130a131aae8689f6a0e8186e63a7f12ea0b5d
https://github.com/simstudioai/sim/pull/9037/files#diff-7e16549ad100382b39702cea73a130a131aae8689f6a0e8186e63a7f12ea0b5d
https://github.com/simstudioai/sim/pull/9037/files#diff-7e16549ad100382b39702cea73a130a131aae8689f6a0e8186e63a7f12ea0b5d
https://github.com/simstudioai/sim/pull/9037/files#diff-7e16549ad100382b39702cea73a130a131aae8689f6a0e8186e63a7f12ea0b5d
https://github.com/simstudioai/sim/pull/9037/files#diff-7e16549ad100382b39702cea73a130a131aae8689f6a0e8186e63a7f12ea0b5d
apps/sim/lib/mcp/tool-result.tshttps://github.com/simstudioai/sim/pull/9037/files#diff-ff4f8d716b657c33b45e32ab5e50facdd25af842c621ae4e0b1b37b1fa2f28c8
View file https://github.com/simstudioai/sim/blob/801261fc74121deb37640420606ac24b6f83f600/apps/sim/lib/mcp/tool-result.ts
Open in desktop https://desktop.github.com
https://github.co/hiddenchars
https://github.com/simstudioai/sim/pull/9037/{{ revealButtonHref }}
https://github.com/simstudioai/sim/pull/9037/files#diff-ff4f8d716b657c33b45e32ab5e50facdd25af842c621ae4e0b1b37b1fa2f28c8
Please reload this pagehttps://github.com/simstudioai/sim/pull/9037/files
https://github.com
Termshttps://docs.github.com/site-policy/github-terms/github-terms-of-service
Privacyhttps://docs.github.com/site-policy/privacy-policies/github-privacy-statement
Securityhttps://github.com/security
Statushttps://www.githubstatus.com/
Communityhttps://github.community/
Docshttps://docs.github.com/
Contacthttps://support.github.com?tags=dotcom-footer

Viewport: width=device-width


URLs of crawlers that visited me.